Using a List of Values Metafield to Display Labels/Badges

You want to use a metafield with multiple values, such as a Material metafield with values like "Wood," "Wool," "Cotton," and "Plastic." This allows you to control when a label or badge appears on your products. However, you are not sure how to set it up.

This guide will help you:

✅ Add a list of values to a metafield condition

✅ Understand how labels/badges display when using a List of Values metafield

Learn more about how to use Metafields in the BSS: Product Labels & Badges app in this article: How to Use Product Metafields to Customize Label/Badge Display?

1. How to add a list of values to a metafield condition

Follow these simple steps:

1. In the Condition settings, select Product condition → With specific metafield(s)

   

2. Click Add metafield(s)

   

3. Choose a metafield with a List of values.

   

   Learn more about how to define a Shopify metafield with a list of values in this article: How to Create Product Metafields in Shopify: A Step-by-Step Guide

4. Click into the first input box and add a value (for example:Wood).

   

5. To add more values, click Add item. A new input field will appear. Now add value in the new field (for example: Wool, Cotton, etc.).

   

6. When you're done, click Save.

   

Tip: To remove a value, click the X icon next to value.

2. How labels/badges display when using a List of Values metafield

💡General rule: A product only needs to match at least one value from the list of values you set for a metafield to satisfy that metafield.

Scenario 1: Only one metafield

Example 1:

• You create a Material metafield condition with values: Wood, Wool, Cotton, Plastic.

• Product A has Material values: Wool, Water.

→ Product A matches (because Wool is included), so the label/badge will display.

Scenario 2: Multiple metafields

You can choose how metafield conditions are matched:

• Matching Option: Must satisfy all metafield → The label/badge appears only if all metafields are satisfied.

• Matching Option: Just need to satisfy 1 of all metafields → The label/badge appears if any metafield is satisfied.

Example 2:

• You create a Material metafield condition with values: Wood, Wool, Cotton, Plastic.

• You create a Age metafield condition with values: Adult, Kids.

Product A has:

• Material: Wool, Water

• Age: (empty)

→ Matching Option: Must satisfy all metafield → Label/badge does not display (because Age is empty and doesn't match).

→ Matching Option: Just need to satisfy 1 of all metafields → Label/badge displays (because Material matches Wool).

3. What to expect

Once you've set everything up, your label/badge will automatically appear on the correct products in your store based on the conditions you defined.