A new theme can change more than design
Themes control how Shopify product data becomes public HTML. A redesign can look correct while changing headings, canonical links, variant behavior, accordions, and Product structured data.
Before publishing, choose five URLs:
- homepage
- top collection
- simple product
- product with several variants
- product with subscription or bundle logic
Save screenshots and the public URLs from the current theme.
Run the owner-visible checks
On the preview theme, verify:
| Check | What good looks like |
|---|---|
| product identity | title and selected variant are obvious |
| price | changes with the selected variant |
| availability | unavailable variants cannot appear purchasable |
| decisive facts | text remains visible on mobile |
| policies | shipping, returns, and subscriptions are reachable |
| market | language and currency match the selected market |
Open accordions. If material, compatibility, or package contents appear only after JavaScript loads, ask the developer whether the content is present in the initial HTML.
Use four technical terms correctly
A canonical URL tells systems which public URL is preferred when several URLs show similar content.
JSON-LD is a common format for Product structured data.
An Offer is the structured representation of price, currency, condition, and availability.
Crawlability means an intended public page can be retrieved without a password wall, security challenge, or accidental robots block.
The store owner does not need to inspect every line of code. These terms define the acceptance ticket for the developer.
Give the developer an exact request
Use this brief:
Compare the five saved production URLs with the theme preview.
Check canonical, Product and Offer JSON-LD, duplicate Product entities,
selected-variant SKU, priceCurrency, availability, robots directives,
and initial HTML for the visible specification content.
Return a table of changed fields and URLs.
Do not accept “schema installed” as a result. The output must describe the correct product and variant.
Verify immediately after publishing
Reopen the five public pages without preview parameters. Check mobile, desktop, and one private browser window. Complete a test add-to-cart for an available and unavailable variant.
If a problem appears, document the URL and selected variant before rolling back. Shopify’s duplicate theme should remain available until the acceptance checks pass.
The technical checklist and commands are in Audit AI visibility after a Shopify theme update.
Community discussion
Add to the article
Ask a technical question, share a storefront result, or challenge a conclusion with evidence.