404 on a page after uploading the theme

Symptom: clicking Homepage / Product in the theme editor redirects to a 404.

Cause: the JSON template references a section type that Shopify rejected during upload.

Fix:

1. Edit code → Sections folder. Check that all section files listed in your templates exist. (Most commonly missing: story-videos.liquid, heading-marker.liquid.)
2. If a file is missing, the zip upload silently dropped it — re-upload the zip as a NEW theme (do not Replace).
3. Logout and login of your Shopify admin to clear cached section list.

Logo appears in wrong colors

If your colored logo (rose-gold, gold, brand color) displays as a strange complementary color (often blue/teal), the Invert logo image setting is enabled.

Fix: Customize → Header → Logo → UN-check Invert logo image.

Notify me adds product to cart

This was a v1 bug. The back-in-stock form was rendered inside the cart form (HTML disallows nested forms). Fixed in v9+.

If you customized the product template and see this, ensure the product-bis snippet is rendered OUTSIDE the {% form 'product' %}...{% endform %} block.

Variant shows “In stock” when stock is 0

Cause: the variant has continue selling when out of stock set to true (pre-order policy), which makes Shopify report available: true even with zero quantity.

Vesperia v30+ detects this case and shows Out of stock. If you customized the inventory logic, ensure the JS / Liquid checks for inventory_quantity <= 0 regardless of available.

Mobile logo is blurry

Cause: the source image is small, or the image_tag is using a low sizes attribute.

Fix: upload a logo at minimum 1000px wide. Vesperia automatically requests up to 4× retina widths.

Theme Store submission errors

• Preset name has invalid characters — use only letters, numbers, spaces. Max 2 words per preset name.
• Must have a preset named X in settings_data.json — add a preset matching your theme_name.
• Must have folders in /listings — create /listings/<preset-handle>/ for each preset with a listing.json + a templates/index.json file at minimum.

Still broken?

Contact support with your store URL and a description of the issue.