Using a List of Values Metafield to Display Labels/Badges

PreviousHow to Create a Label or Badge that Shows Product Metafield Content Automatically NextDisplay a Badge Next to the Product Price

Last updated 1 month ago

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:

In the Condition settings, select Product condition → With specific metafield(s)
Click Add metafield(s)
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
Click into the first input box and add a value (for example:Wood).
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.).
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.

PreviousHow to Create a Label or Badge that Shows Product Metafield Content Automatically NextDisplay a Badge Next to the Product Price

Last updated 1 month ago

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:

In the Condition settings, select Product condition → With specific metafield(s)
Click Add metafield(s)
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
Click into the first input box and add a value (for example:Wood).
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.).
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.