01
Step 1
Take the affected product page with the options it renders, the catalog variant data for that product, the option names and values in use, and the publication and availability status of every variant.
Back to topic
Spark playbook scenarios · Spark: AI Store Assistant
Investigate missing or confusing variant information on a page
A product page shows variant options that do not line up with the catalog, leaving buyers unable to select a combination. In this case, the immediate task is to investigate missing or confusing variant information on a page. The workflow should produce a prioritized product issue report naming the missing options, unclear labels and mismatched values.
Topic
Product Data Quality and Audits
Target keyword
shopify variant display issues
Copyable AI prompt
A prompt you can drop directly into Spark
First replace every [bracketed] placeholder with real store scope and constraints, then add any actual records or data you have, and paste it into your preferred AI assistant or Spark agent. Spark will follow this page's workflow to produce structured output and verification steps.
ai-prompt.txt
Act as a Shopify operations specialist.
Help me investigate missing or confusing variant information on a page.
My store context is [describe the business, products and target audience].
My scope is [specify the affected products, pages, customers or reporting period]. Use these inputs: [the affected product page with the options it renders, the catalog variant data for that product, the option names and values in use, and the publication and availability status of every variant].
Compare the rendered options against the catalog value by value, separate options missing from the page, labels naming no recorded value and values contradicting the record, and check that each combination a buyer can select resolves to a real variant.
Return a prioritized product issue report with evidence and suggested fixes for the specified task.
Show the relevant evidence or before-and-after examples and explain how I can verify the result.
If essential data is missing, ask for it and mark unsupported conclusions as unknown.
Do not invent metrics, product claims or customer facts.
For any publication, message, account or store change, use only connected tools within my explicitly authorized scope and report success only after verification; otherwise provide the draft or proposed steps.How to solve
A recommended resolution workflow
Split the work into input, judgment, and deliverable phases. Verify each step's output before moving to the next.
02
Step 2
Compare the rendered options against the catalog value by value, separate options missing from the page, labels naming no recorded value and values contradicting the record, and check that each combination a buyer can select resolves to a real variant.
03
Step 3
Deliver a prioritized product issue report naming the missing options, unclear labels and mismatched values with the evidence for each, then confirm every catalog variant is accounted for as shown, hidden or mismatched, and flag any renaming as a merchant decision.
FAQ
Common questions when running this scenario
Cover decision rules, frequent misunderstandings, and required inputs so the team aligns on prerequisites before execution.
What hides a variant that exists in the catalog?
An option value that no longer matches, a variant left unpublished, or zero availability. Check each in turn because the fixes differ: realign the value, publish the variant, or restock it.
How is an unclear option label identified?
A label a buyer cannot map to a recorded value, such as two options sharing a name or one value written in different casing. Test it by asking which catalog value the label actually selects.
Should option names change as part of the fix?
Only with the merchant agreement, because renaming breaks saved links and historical reporting. Where a rename is approved, keep the old value working as an alias during the transition.
Related scenarios
Continue with adjacent or same-topic scenarios
Start with scenarios under the same topic, then expand into cross-topic matches suggested by similarity.
Next step
Want these AI scenarios embedded directly into daily operations?
Ciwi Spark builds Shopify-native AI tools and agents around the workflows merchants actually run: research, ads, translation, and customer support. Stop rewriting the same prompts by hand.