Troubleshooting
Quick lookup for common issues. Theme-editor-specific problems live in
Theme editor → Troubleshooting.
The block doesn't render at all
| Symptom |
Likely cause |
Fix |
| Block area is blank, no skeleton |
Block isn't placed on this product template |
Add the block to the right template |
| Skeleton appears, never resolves |
API call failing |
Open DevTools → Network → look for /apps/parts-diagram/* errors. Share the error code with support |
<noscript> message visible |
JavaScript disabled in the browser |
Tell the shopper to enable JS — fundamental requirement |
| Looks fine in incognito but not in normal browser |
Browser extension (ad-blocker, privacy tool) blocking |
Test with extensions disabled |
Hotspots are misaligned
| Symptom |
Cause |
Fix |
| All hotspots offset by a fixed amount |
Image was replaced with one of different proportions |
Re-upload the original image, or redraw hotspots on the new one |
| Hotspots drift on resize |
Theme is wrapping the diagram in a container with non-stretching layout |
Contact support — usually a CSS conflict we can fix |
| Hotspots correct on desktop, off on mobile |
Theme injects responsive transforms |
Same as above |
Pricing or stock looks wrong
| Symptom |
Cause |
Fix |
| Old price flashes briefly before correct one |
Snapshot vs. live data — first paint uses snapshot |
Expected behavior; if persistent, re-save the hotspot mapping in the editor |
| Prices missing entirely |
Show prices off, or hotspot has no variant mapping |
Check Settings → Storefront and the diagram editor |
| Stock state stuck on "Sold out" but variant is in stock |
Inventory tracking edge case |
Reload page; if persistent, contact support |
| Sale price not showing struck-through |
Variant has no compare_at_price, or it's lower than price |
Set compare_at_price higher than price on the variant in Shopify Admin |
Variant picker problems
| Symptom |
Cause |
Fix |
| Variant picker not appearing |
Hotspot locked to single variant, or product only has Default Title variant |
Open the editor and verify the hotspot's variant field is "Any variant"; verify the product has real options |
| Picker shows but variant change doesn't update price/stock |
Cached storefront data |
Hard reload (Ctrl+Shift+R / Cmd+Shift+R) |
| Picker shows raw "Default Title" option |
Product is missing variant configuration in Shopify |
Configure variants on the product in Shopify Admin |
Add to cart not working
| Symptom |
Cause |
Fix |
| Click does nothing, no error |
Theme is overriding cart events |
Test on a Dawn-based theme to isolate; share theme name with support |
| "Variant unavailable" error |
Variant was deleted between page load and click |
Reload the page |
| Item adds but cart count doesn't update |
Theme uses a non-standard cart UI |
Set Cart redirect mode to Open cart drawer or Go to cart page |
Admin UI issues
| Symptom |
Cause |
Fix |
| Embedded admin shows blank screen |
Shopify session expired |
Refresh the Shopify Admin page |
| "Block missing" warning, but block is added |
Shop-level health check is stale |
Click Re-check on the dashboard |
| Hotspot save fails repeatedly |
Rate-limit or API outage |
Wait a minute and retry; persistent failures → contact support |
| Image upload fails for large file |
File over 5 MB |
Compress the image (e.g. with pngcrush or an online tool) |
Still stuck?
If your issue isn't above:
- Capture a screenshot showing the problem.
- Open browser DevTools → Console, copy any messages starting with
[parts-diagram] or anything red/yellow.
- Note the affected product page URL.
- Email all three to support.