How to Use Variant Metafields to Customize Label/Badge Display

In addition to product-level conditions, the BSS Product Labels & Badges app now supports variant metafields as a condition to display labels or badges. This allows you to show the right labels/badges for specific variants of a product based on custom data.

1. What is a Variant Metafield?

Variant metafields are a form of custom data attached to individual product variants in Shopify. While product metafields apply to the entire product, variant metafields allow you to store and target unique information per variant.

Variant metafields are created similarly to product metafields. Just make sure to select Variant as the resource type before defining your metafield.

Learn more: How to Create Product Metafields in Shopify: A Step-by-Step Guide

2. Why Use Variant Metafields for Labels/Badges Display?

With variant metafields, you can ensure that a label/badge only shows up when a specific variant meets a metafield condition — giving you even more control and personalization across your storefront.

3. Step-by-step Guide

1️⃣ Step 1: Choose Display Condition Type

Go to Product Conditions > Select With specific Metafield(s)

2️⃣ Step 2: Choose the Metafield You Want to Use

• Click Add Metafield

• Choose Metafield type = Variant Metafield

• Choose a Metafield from your existing Shopify Metafield list.

Select Variant Metafields

• Our app supports many data types, including:

  • Single line text, Multi-line text

  • Integer, Decimal, Date and Time, Date

  • Dimension, Volume, Weight, True or False, Color (code)

  • Rating, Money

3️⃣ Step 3: Enter the Value You Want to Match

Enter the value you want to match for the Metafield. The app will then find products with matching values and display the corresponding label/badge

Enter the value you want to match

Examples:

• Variant Metafield origin = organic: The label/badge will appear on variants where the origin metafield is set to organic

• Variant Metafield rating = 5: The label/badge will appear on variants where the rating metafield is set to 5 .

4️⃣ Step 4: Choose Matching Option

• Match all: Variant must match all Variant Metafield conditions to display the label/badge.

• Match one: Variant only needs to match one Variant Metafield condition to display the label/badge.

Matching Options

5️⃣ Step 5: Save and Preview on Your Storefront

4. Pro Tips

• Be sure to enter values correctly for your Metafields.

• This feature is available only on the Platinum plan.

• Ensure your variant has the Metafield with the value you set.

• Labels/Badges with Variant Metafield conditions will be displayed on the product card if any variant of the product matches the condition.

• You can also use product metafields as conditions to display labels or badges: How to Use Product Metafields to Customize Label/Badge Display?