Adding color swatches using category metafields

Category metafields map to specific product categories in Shopify's Standard Product Taxonomy. Category metafields, which are called product attributes in the taxonomy, help you add the right information to your products to make them more discoverable by visitors on your site, on marketplaces, and on search engines.

For example, if you add the product category Apparel & Accessories > Clothing > Clothing Tops > Shirts, then you can add category metafields for clothing size, neckline, sleeve length type, and more. Based on Shopify Magic predictions, some category metafields are added by default. Other category metafields might be suggested and you can choose to add them to your store. Category metafields have default entries that you can either use as is or customize further.

You can connect category metafields to your product variant options and the entries to your option values. This means that you can edit the color black to be graphite and your variant values are updated anywhere that color is used. When you use color entries as variant options, you can display variant options as swatches for color options on your storefront product pages.

You can add category metafields to your products directly from your Shopify admin.

To complete all the steps, you need the latest version of Dawn or a theme that supports variant options with swatches. If you're using vintage themes, or if you want to add features that your theme doesn't support, then you can edit your theme code or hire a Shopify Partner to help you.

This is a 4-step tutorial that introduces Shopify's Standard Product Taxonomy, adding category metafields, connecting variant options to category metafields, and publishing color swatches on your online store.

Step one: Add a product category

A product category is selected from the pre-defined categories in Shopify's Standard Product Taxonomy.

Shopify's Standard Product Taxonomy is used for the following purposes:

  • Unlock product attributes, referred to as category metafields, that map to each product category.
  • Manage your products better within Shopify, for example, as a condition for a smart collection or to help filter your product list.
  • Make it easier to sell products on other channels that require a standardized product type, such as Facebook or Google.
  • Determine the rate at which the product is taxed when you're using Shopify Tax. Your products might be subject to special rates or exemptions. When a product is categorized correctly, the most accurate tax rate is collected at checkout. Collecting too much or not enough sales tax can create financial or legal liability for your business.

An example of a product category is Apparel & Accessories > Clothing > Clothing Tops > Shirts. This is the example category used throughout this tutorial. However, you can add color swatches for any category metafield with the color product attribute.

Other category metafields for Apparel & Accessories > Clothing > Clothing Tops > Shirts include size, neckline, sleeve length type, top length type, age group, fabric, target gender, and clothing features. Category metafields have default entries that you can either use as is or customize further to maintain consistent branding. For example, if the color black isn't in line with your branding, then you can rename it to graphite.

Depending on the information and media you provide for a product, a category might be autofilled. You can change to a different category.

Steps:

Desktop
  1. From your Shopify admin, click Products.
  2. Click a product.
  3. In the Category section, select Apparel & Accessories > Clothing > Clothing Tops > Shirts or another Category with the color category metafield.
  4. Click Save.
iPhone
  1. From the Shopify app, go to Products > All products.
  2. Tap a product to edit it, or search for one.
  3. In the Category section, tap Select category.
  4. Select Apparel & Accessories > Clothing > Clothing Tops > Shirts or another Category with the color product attribute.
  5. Tap Save.
Android
  1. From the Shopify app, go to Products > All products.
  2. Tap a product to edit it, or search for one.
  3. In the Category section, tap Select category.
  4. Select Apparel & Accessories > Clothing > Clothing Tops > Shirts or another Category with the color product attribute.
  5. Tap the checkmark icon to save.

Step two: Add and edit entries for your category metafields

After you add a product category, you can add all the entries that you need for your product's variant option values.

Steps:

Desktop
  1. From your Shopify admin, go to Products.
  2. Click the product with the category metafields that you want to edit or add.
  3. To add an entry from the default entries, complete the following tasks:
    1. In the Category metafields section, click the category metafield, and then click the entry that you want to edit.
    2. Edit the fields as needed.
    3. Click Save.
  4. To add a custom entry, complete the following tasks:
    1. In the Category metafields section, click the category metafield, and then click Add new entry
    2. Fill out the fields for the entry.
    3. Click Save.
  5. Click Save.
iPhone
  1. From the Shopify app, go to Products > All products.
  2. Tap the product with the category metafields you want to edit or add.
  3. To add an entry from the default entries, complete the following tasks:
    1. In the Metafields section, tap View all.
    2. Tap the category metafield. Select additional values.
    3. Tap Save.
  4. To add a custom entry, complete the following tasks:
    1. In the Metafields section, tap View all.
    2. Tap the category metafield.
    3. Tap +.
    4. Fill out the fields for the entry.
    5. Tap Save.
Android
  1. From the Shopify app, go to Products > All products.
  2. Tap the product with the category metafields you want to edit or add.
  3. To add an entry from the default entries, complete the following tasks:
    1. In the Metafields section, tap View all.
    2. Tap the category metafield. Select additional values.
    3. Tap Save.
  4. To add a custom entry, complete the following tasks:
    1. In the Metafields section, tap View all.
    2. Tap the category metafield.
    3. Tap +.
    4. Fill out the fields for the entry.
    5. Tap Save.

Step three: Connect your category metafields to variant options

For the purpose of this tutorial, you'll be connecting the category metafield for color. You can connect any other category metafields, as needed.

When you're adding a variant, a list of category metafields display that you can connect to or you can create a custom option.

Steps:

Desktop
  1. From your Shopify admin, go to Products.

  2. Click the product that you want to edit.

  3. In the Variants section, click + Add options like size or color.

  4. If a category metafield is available to connect to, then select it. The option values are automatically filled with any entries you have added to the category metafield. You can select more option values or create new ones.

  5. Optional: If you want to add custom option values, then click Edit, and then click Add new entry. Fill out the entry fields, and then click Save.

  6. Click Save to save the product.

iPhone
  1. From the Shopify app, go to Products > All products.
  2. Tap a product.
  3. In the Variants section, tap + Add options like size or color.
  4. If a category metafield is available to connect to, then tap to select it. The option values are automatically filled with any entries you have added to the category metafield. You can select more option values or create new ones.
  5. Optional: If you want to add custom option values, then type the option in the Add value field. Tap + Add {option name}, fill out the entry fields, and then tap Save.
  6. Tap Save to save the product.
Android
  1. From the Shopify app, go to Products > All products.
  2. Tap a product.
  3. If you have no variant options, then in the Variants section, tap + Add options like size or color. If you have variant options, then in Options section, tap Edit, and then tap Add option.
  4. If a category metafield is available to connect to, then tap to select it. The option values are automatically filled with any entries you have added to the category metafield. You can select more option values or create new ones by tapping Add value, and then tapping the values that you want to add.
  5. Optional: If you want to add custom option values, then type the option in the Add value field. Tap + Add {option name}, fill out the entry fields, and then tap .
  6. Tap to save the product.

Migrate your variant options to category metafields

If you've already created a product with variant options, then you can migrate your values to category metafields and quickly generate multiple new variant combinations. If you use category metafields to create your variant options, then you can update variant option names in a single location and it updates wherever that category metafield value is connected.

Connect the category metafield to an existing option by clicking the dynamic source icon ;

Desktop

Steps:

  1. From your Shopify admin, go to Products.

  2. Click the product with variant options that you want to migrate to category metafields.

  3. Optional: If your product doesn't have a Category, then complete one of the following steps:

    • Enter your product’s category, and then select the most accurate result from the Product category list.
    • Click through each level of the categories and subcategories to find your product category.
    • Click Suggested to accept the suggested category.
  4. To connect the your variant option to a category metafield, complete either of the following tasks:

    • Click an existing option, click the dynamic source icon, and then click the category metafield that you want to connect.
    • Click Add another option, and then click the category metafield that you want to connect.
  5. Click Save.

iPhone
  1. From the Shopify app, go to Products > All products.
  2. Tap the product with variant options that you want to migrate to category metafields.
  3. Optional: If your product doesn't have a Category, then complete one of the following steps:
    • Tap Select category, enter your product’s category, and then select the most accurate result from the Category list.
    • Tap Select category, tap through each level of the categories and subcategories to find the most accurate product category, and then tap the category to select it.
  4. In the Options section, tap Edit.
  5. To connect the your variant option to a category metafield, complete either of the following tasks:
    • Tap an existing option, tap No connected source, and then tap the category metafield that you want to connect.
    • Tap Add option, and then tap the category metafield that you want to connect.
  6. A dialog displays with a message that the existing values will be cleared. Tap Continue.
  7. Tap Save.
Android
  1. From the Shopify app, go to Products > All products.
  2. Tap the product with variant options that you want to migrate to category metafields.
  3. Optional: If your product doesn't have a Category, then complete one of the following steps:
    • Tap Select category, enter your product’s category, and then select the most accurate result from the Category list.
    • Tap Select category, tap through each level of the categories and subcategories to find the most accurate product category, and then tap the category to select it.
  4. In the Options section, tap Edit.
  5. To connect the your variant option to a category metafield, complete either of the following tasks:
    • Tap an existing option, tap No connected source, and then tap the category metafield that you want to connect.
    • Tap Add option, and then tap the category metafield that you want to connect.
  6. A dialog displays with a message that the existing values will be cleared. Tap Continue.
  7. Tap .

Step four: Add color swatches to your online store

Next you will publish your color swatches on your online store.

Sample online store with selectable swatch options

Sample dawn settings for swatches

Customize swatches in Dawn

  1. From your Shopify admin, go to Online Store > Themes.
  2. Make sure you have the latest version of Dawn installed, then click Customize.
  3. Navigate to the product that you added color options to.
  4. Optional: To customize swatches, click the Variant picker block. You can change the display of the swatches by choosing between Circle, Square, or None.
  5. Click Save to save the theme.

You can now navigate to the product page on your online store and the color swatches are displayed for your variant option values.

Can’t find the answers you’re looking for? We’re here to help.