Always duplicate first

Before editing code:

1. Online Store → Themes.
2. Click Actions → Duplicate on your Vesperia row.
3. Make all changes on the duplicate. When happy, publish it.

This gives you a one-click rollback.

File structure overview

• layout/theme.liquid — the page shell (head, body wrapper).
• sections/*.liquid — every section the user can add. Includes its own schema.
• snippets/*.liquid — reusable Liquid fragments (rendered via {% render %}).
• assets/* — CSS, JS, images, SVGs.
• config/settings_schema.json — theme settings categories and defaults.
• config/settings_data.json — the current values + the 5 presets.
• templates/*.json — page templates (index, collection, product, page).

Common edits

• Add a new menu link — do this in Online Store → Navigation, NOT in code.
• Change a button label — prefer Theme settings or the Customizer. Only edit Liquid if no setting exists.
• Override a font — prefer Theme settings → Typography. Only edit CSS if you need a font outside Shopify’s library.

Theme Check

Shopify provides shopify theme check CLI tool. Run it locally if you make significant Liquid changes:

shopify theme check --auto-correct

It will catch syntax errors before you upload.

Rollback

Online Store → Themes → Older versions — you can restore any version of the theme from the last 30 days.