Shopify variant option names: best practices and examples
Variant option names (such as “Color”, “Size”, “Material”) may seem innocuous. These words are attached to your products and are visible to Shopify Theme (some themes display option names differently in the variant select), to Shopify Apps (some variant swipe apps look for variant color options automatically), to Google Shopping (option names used to categorize product variants) and to your customers (so that they understand the option differences between variant products).
To avoid issues later on, a poorly named option will prevent swatches from displaying because a theme will not recognise ‘Colour’ as a colour option. Products will be rejected for Google Shopping if size options have names other than ‘Size’. customers may be confused about the meaning of ‘Type’ if it could be applicable in several ways. A guide to giving options descriptive names to avoid later problems.
In this post
- Why option names matter
- Color option naming
- Size option naming
- Material and other option naming
- Option value naming (the actual variants)
- Common naming mistakes
- FAQ
Why option names matter
Option names affect four things:
- Theme swatch detection. Most themes check if an option is named “Color” (or “Colour”) to decide whether to render it as color swatches or a dropdown. If you name it “Shade” or “Variant Color”, the theme might not recognize it and falls back to a text dropdown.
- App behavior. Swatch apps like Rubik Variant Images and themes like Prestige auto-detect color options by name. Standard names trigger automatic behavior. Non-standard names require manual configuration.
- Google Shopping feed. Google Shopping expects specific option names for product attributes. “Size” maps to the size attribute. “Color” maps to the color attribute. Non-standard names may not map correctly, leading to feed errors or incomplete product data.
- Customer understanding. Customers expect to see “Color” and “Size” on a product page. “Hue” or “Dimensions” works but adds a moment of confusion. In e-commerce, confusion costs conversions.
Color option naming
Use “Color” (US English) or “Colour” (UK English). Most themes and apps recognize both. Do not use:
- “Shade” (not recognized by most swatch detection)
- “Hue” (confusing to customers)
- “Variant” (too generic)
- “Product Color” (some themes only match exact “Color”)
If you are selling to customers in the US and UK then “Color” is safer as both Shopify and most apps default to US English for their language settings. Both Shopify and Prestige recognise both US and UK English, Dawn only recognises “Color”. Check your theme documentation for specific details.
For the option values (the actual color names) use descriptive names for the color e.g. “Navy Blue” not “Navy”, “Forest Green” not “FG-03”. These names will appear in the variant picker, in the cart and order confirmations as well as in the Google Shopping feeds. The names should be readable everywhere.
Size option naming
Use “Size” for apparel. Alternatives for specific product types:
| Product type | Option name | Example values |
|---|---|---|
| Clothing | Size | XS, S, M, L, XL, XXL |
| Shoes | Size | US 7, US 8, US 9 (include country prefix) |
| Rings | Ring Size | 5, 6, 7, 8, 9 |
| Furniture | Size | Twin, Full, Queen, King |
| Electronics | Storage | 128GB, 256GB, 512GB |
For shoes always include the sizing system (US, EU, UK) in the values, not just the number. ” US 9″ is perfect. ” 9″ is not as it could mean US, EU or UK which could result in a return if incorrectly bought.
Material and other option naming
Common third-option names:
- “Material” for fabric, metal, or construction type (Cotton, Polyester, Leather)
- “Style” for design variations (Slim Fit, Regular Fit, Relaxed)
- “Length” for pants or curtains (30″, 32″, 34″)
- “Scent” for candles or personal care (Lavender, Vanilla, Unscented)
- “Flavor” for food or supplements (Chocolate, Vanilla, Strawberry)
Keep option names brief, ideally 1-2 words. This name appears next to the picker on the product page and ” Material” is a better option than “Fabric Material Type”. On the full desktop view it doesn’t look too bad, but it can break mobile layouts.
Option value naming (the actual variants)
Option values (Red, Blue, S, M, Cotton etc) are the individual selections within options (Option etc) and have their own set of best practices.
- Be consistent across products. If one product uses “Navy Blue” and another uses “Navy”, they appear as different colors in Google Shopping and collection filters. Pick one name and use it everywhere.
- Use customer-facing names, not internal codes. “Ocean Blue” is better than “CLR-047”. Internal codes belong in SKUs, not option values.
- Match CSS color names when possible. Themes that auto-detect swatch colors from option values rely on CSS color name matching. “Red”, “Blue”, “Green” map automatically. “Dusty Rose” does not. For custom names, set the swatch color via metafields or an app.
- Order matters. Shopify displays option values in the order you set them in the product editor. Put the most popular options first. Customers are more likely to select from the first few visible options.
Option value text shows color names under swatches. ” Midnight Blue” under the very dark blue swatch is helpful. ” MB” is not.
Common naming mistakes
- Using “Title” as an option name. “Title” is a reserved word in Shopify. It is the default option name for single-variant products. Using it for multi-variant products creates confusing displays and can break some apps.
- Inconsistent capitalization. “color” and “Color” might be treated as different option names by themes and apps. CSS selectors like
[data-option-name="Color"]are case-sensitive. Standardize on title case (“Color”, “Size”, “Material”). - Cramming two attributes into one option. “Size-Color” as a single option with values like “S-Red”, “M-Blue” works technically but creates a terrible customer experience. Use separate options for separate attributes.
- Using abbreviations. “Sz” instead of “Size” or “Mat” instead of “Material”. Saves a few pixels, confuses every customer. Not worth it.
For stores where option naming consistency matters at scale, Rubik Variant Images handles swatch rendering regardless of the exact option name. You configure which option displays as swatches in the app settings, so even non-standard names (“Shade”, “Colour”, “Finish”) work correctly. For grouped products, Rubik Combined Listings maintains consistent swatch display across all products in a group.
“This app is perfect. it is incredibly easy to set up and use. There are so many cool ways you can set up your variant images AND adjust your swatches. The youtube tutorials are super helpful. I got a bit stuck trying to set up one of my products and Zulf was super quick to respond and help. Definitely recommend it if you are reading this ;D”
Anonymous merchant, Rubik Variant Images on the Shopify App Store
Frequently asked questions
Does the option name affect how Shopify renders the variant picker?
Yes. Many themes look at the option name to decide between swatches and a dropdown. For options named “Color” or “Colour” you might see color swatches, any other option will get a dropdown or a button instead. The specifics depend on the theme you are using.
Can I rename an option after creating variants?
To change the name of an option go to the product in the Shopify admin and click on the option name you want to rename. Rename the option name. The name of the option has been changed. Note that renaming the option name does not change anything for existing variants or variant values. However if the option name is being used by a theme or app for swatch detection, renaming the option name can cause changes to how the swatches are displayed.
Should I use “Color” or “Colour” for my option name?
“Color” (US English) is safer here. Shopify’s core application and many Shopify apps default to US English, and most themes will accept both “Color” and “Colour”. However some themes may be configured to only recognise one of these options, so you should test with your current theme before making the change to ensure it will not have any adverse effects on your store. If you are marketing to customers in the UK and/or Australia, you may prefer to use “Colour”.
Do option names affect Google Shopping feeds?
Google Shopping actually uses “Color” for our attribute tag color and “Size” for size. If you happen to use a non standard name for one of these (like Shade or Dimensions) it may not map automatically. You’ll then need to do a manual attribute mapping within your chosen feed app or in Google Merchant Center.
What happens if two products use different option names for the same attribute?
Collection page filters treat them as separate filter groups. ” Color” and “Colour” appear as two different filters. Swatch apps may handle them differently. Google Shopping may categorize them separately. It’s a good idea to standardize option names throughout your entire catalog to ensure that your nomenclature is consistent.
