Reviewed 13 October 2026.
Start in Cuebase, then correct variants in Shopify
Open Catalog Readiness and select a scanned product. Its rule breakdown reports option names after excluding Shopify’s default Title option. That can reveal a product with no structured options, but a single-variant product may be complete without them.
Cuebase does not create, rename, or apply Shopify variant options, values, prices, inventory, images, or variant metafields. Make those changes in Shopify admin, then run a new scan. Generate improvements remains useful for product-level draft copy and custom attributes, but applying those drafts does not change variants.
Treat each option as a buyer decision
In Shopify, option values combine to make product variants. A product may have options such as size, color, or material; each purchasable combination is a distinct variant. The product description can explain what the whole product family is. It cannot safely stand in for differences that change price, capacity, included items, dimensions, availability, or a shopper’s choice.
Shopify’s ProductOption reference documents this relationship between option values and variants. Use an option name that tells the shopper what they are choosing, then use values that distinguish those choices. “Standard” and “Premium” only work when the product page explains the concrete difference. “500 ml” and “750 ml” work when capacity is the difference. “Single” and “Set of 2” work when the buyer receives a different quantity.
| Difference | Option name and value | Where to explain more |
|---|---|---|
| Physical size | Size: Small, Medium, Large | Size chart or dimensions for each value. |
| Capacity | Capacity: 500 ml, 750 ml | Variant data or a specification block tied to the selected choice. |
| Quantity | Pack size: 1, 2, 4 | Make included quantity visible before purchase. |
| Color | Color: Graphite, Sand | Swatch or image only when it matches the exact variant. |
| Different contents | Set: Starter, Complete | Name each included item in an accessible list. |
Worked example: a fictional lunch-container range
This example is fictional. It is meant to show a data model, not product specifications or a recommended inventory structure for any merchant.
The fictional “Dayline Lunch Container” comes in two capacities and two pack sizes. Its original choices are “Regular,” “Large,” “Single,” and “Family.” Those labels leave the shopper to guess about capacity and quantity. Replace them with structured values and a small explanation.
| Data field | Illustrative value | Fact the product record must support |
|---|---|---|
| Option: Capacity | 600 ml; 1,000 ml | Each container’s measured capacity. |
| Option: Pack size | 1 container; 2 containers | The quantity in the purchase. |
| Variant metadata: included items | Single: 1 container and 1 lid; double: 2 containers and 2 lids | Exact contents of each purchasable combination. |
| Option: Color | Sand; Slate | The color attached to the selected variant and its image. |
The page’s shared description can say what the container range is. It should not say “includes two lids” unless every choice includes two lids. Put shared care advice in the product description or a shared metafield. Put choice-specific facts with the variant or make the difference visible in the picker and selected-variant content.
Shopify admin data and storefront content are separate checks
Saving a precise option name in Shopify does not guarantee that the storefront makes the consequence clear. Your theme decides how options, selected variants, swatches, price, media, and metafields are shown. Shopify documents that a compatible theme can connect product and variant metafields to product pages. Inspect the live or preview page with each important combination selected.
Check each one for the facts that influence a purchase: the selected value, price, availability, image, capacity or dimension, and included items. A color swatch is useful only if it maps to the right color value. A selected image is useful only if it represents the selected variant. Do not use a general product photo to imply a choice-specific feature.
Use Cuebase to spot missing structure, not to edit variants
Open Catalog Readiness in Cuebase and select a scanned product. Its rule breakdown reports structured options from the option names Shopify provides. A product with no option names other than Title may show a partial result; that can be fine for a single-variant product. It is a prompt to review, not proof that every product needs variants.
Cuebase does not generate, rename, or apply Shopify variant options, values, prices, inventory, images, or variant metafields. Make those changes in Shopify admin. Afterward, run a new scan so Catalog Readiness reflects the updated option names and the other product data. You can separately use Generate improvements for reviewable product-level copy and custom attribute suggestions; applying those drafts does not rewrite your variants.
A reliable variant review loop
List every purchasable combination
Write the option values, price, SKU, barcode, availability, included items, and any decision-making specification for each variant.
Find ambiguous labels
Replace labels such as “Regular,” “Classic,” or “Better” when they conceal a measurable difference.
Separate shared and changing facts
Keep a fact at the product level only when it is true for every variant. Move changing facts to the relevant variant data or selection-specific display.
Inspect the storefront
Select each important combination. Confirm the chosen value, price, availability, image, and contents all agree.
Rescan in Cuebase
Use the updated readiness result as a catalog check, then review any generated product-level drafts before applying them.
Get the Shopify variant comparison sheet (CSV). Use one row per purchasable variant to expose missing facts before a shopper does.
One question before you publish
Can a shopper explain the difference between any two choices without guessing? If the answer is no, fix the field, the selected-variant content, or both. This improves the accuracy of the listing. It does not promise a search placement or an AI recommendation. Continue with the Shopify product-data guide, choose the first 10 products to improve, and check common catalog gaps. Then start your free catalog scan.