> For the complete documentation index, see [llms.txt](https://ta-product-labels-and-badges.tech-arms.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ta-product-labels-and-badges.tech-arms.io/setup-conditions/product-conditions/include-products/using-a-list-of-values-metafield-to-display-labels-badges.md).

# 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 **TA: Product Labels & Badges** app in this article: [How to Use Product Metafields to Customize Label/Badge Display?](/setup-conditions/product-conditions/include-products/how-to-use-product-metafields-to-customize-label-badge-display.md)

***

### 1. How to add a list of values to a metafield condition <a href="#id-1.-how-to-add-a-list-of-values-to-a-metafield-condition" id="id-1.-how-to-add-a-list-of-values-to-a-metafield-condition"></a>

Follow these simple steps:

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

   <figure><img src="https://product-labels-docs.tech-arms.io/~gitbook/image?url=https%3A%2F%2F340561356-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FNvBHInFsm4Ct08xZ2f0e%252Fuploads%252Fgit-blob-0118ff6c19a1c8489b2b52d515ea3e7140d1cfa1%252Fimage%2520%281%29.png%3Falt%3Dmedia&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=487b7332&#x26;sv=2" alt=""><figcaption></figcaption></figure>
2. Click **Add metafield(s)**

   <figure><img src="https://product-labels-docs.tech-arms.io/~gitbook/image?url=https%3A%2F%2F340561356-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FNvBHInFsm4Ct08xZ2f0e%252Fuploads%252Fgit-blob-9f0ebe49454d3bd8818f748c16a73e7b6715bd79%252Fimage%2520%282%29.png%3Falt%3Dmedia&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=9f14b532&#x26;sv=2" alt=""><figcaption></figcaption></figure>
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](/faqs/pro-tips/how-to-create-product-metafields-in-shopify-a-step-by-step-guide.md)

   <figure><img src="https://product-labels-docs.tech-arms.io/~gitbook/image?url=https%3A%2F%2F340561356-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FNvBHInFsm4Ct08xZ2f0e%252Fuploads%252Fgit-blob-0dfb3030e24cb9b0ac10a17a8e420baa53a5e47d%252Fimage%2520%283%29.png%3Falt%3Dmedia&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=2819c69e&#x26;sv=2" alt=""><figcaption></figcaption></figure>
4. Click into the first input box and add a value (for example:`Wood`).

   <figure><img src="https://product-labels-docs.tech-arms.io/~gitbook/image?url=https%3A%2F%2F340561356-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FNvBHInFsm4Ct08xZ2f0e%252Fuploads%252Fgit-blob-3402e67694c9dc4a0b560701fc79a99fd5e8d1f3%252Flist%2520of%2520value%25201.gif%3Falt%3Dmedia&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=a0e628cb&#x26;sv=2" alt=""><figcaption></figcaption></figure>
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.).

   <figure><img src="https://product-labels-docs.tech-arms.io/~gitbook/image?url=https%3A%2F%2F340561356-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FNvBHInFsm4Ct08xZ2f0e%252Fuploads%252Fgit-blob-7a953cb3e669e7b869b3948d6f65f06b2578d8cd%252Flist%2520of%2520value%25202.gif%3Falt%3Dmedia&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=74dbf903&#x26;sv=2" alt=""><figcaption></figcaption></figure>
6. When you're done, click **Save**.

   <figure><img src="https://product-labels-docs.tech-arms.io/~gitbook/image?url=https%3A%2F%2F340561356-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FNvBHInFsm4Ct08xZ2f0e%252Fuploads%252Fgit-blob-720ae0b8e3e151fe2a0f7bec0df6e575ea21be0b%252Fimage%2520%284%29.png%3Falt%3Dmedia&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=75817ce&#x26;sv=2" alt=""><figcaption></figcaption></figure>

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

***

### 2. How labels/badges display when using a List of Values metafield <a href="#id-2.-how-labels-badges-display-when-using-a-list-of-values-metafield" id="id-2.-how-labels-badges-display-when-using-a-list-of-values-metafield"></a>

💡**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`).

💡 **Tip:** Ensure that Storefront API access is turned on in the Metafield.

<figure><img src="https://product-labels-docs.tech-arms.io/~gitbook/image?url=https%3A%2F%2F340561356-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FNvBHInFsm4Ct08xZ2f0e%252Fuploads%252FqMoWxkPK6DfHfO15398t%252Fimage.png%3Falt%3Dmedia%26token%3D95b9acae-94a8-4779-a9c6-92a769aff176&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=df173af8&#x26;sv=2" alt=""><figcaption></figcaption></figure>

***

### 3. What to expect <a href="#id-3.-what-to-expect" id="id-3.-what-to-expect"></a>

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.
