The Complete Guide to Migrating Your Shopify Store to Online Store 2.0

Why OS 2.0 Is Worth the Effort

If your Shopify store is still running on a legacy theme — anything built before 2021's OS 2.0 release — you're leaving money on the table. Not because the old theme is broken, but because your team can't move fast without a developer.

Online Store 2.0 changes that.

With OS 2.0, every page in your store becomes customizable through the Theme Editor — no code required. Product pages, collection pages, blog posts — all of them get the same drag-and-drop experience that the homepage always had.

What Actually Changes

Sections Everywhere

In legacy themes, sections were only available on the homepage. OS 2.0 extends them to every page type. Your team can add, remove, and reorder content blocks on any page without touching code.

JSON Templates

OS 2.0 stores page layouts as JSON files rather than hardcoded Liquid. This means:

• Multiple templates per page type (e.g., product.default, product.bundle, product.preorder)
• Drag-and-drop layout editing in the Theme Editor
• Version control friendly — layouts are just files

Metafields

Metafields let you attach custom data to products, collections, customers, and orders. In OS 2.0, you can display metafield values directly in the Theme Editor — no Liquid required. This is huge for brands with complex product data.

App Blocks

App developers can now ship OS 2.0 app blocks that your team can place on any page using the Theme Editor. No more pasting script tags into theme.liquid.

The Migration Process

Step 1: Audit Your Current Theme

Before touching anything, document what you have:

• Which custom sections exist and what they do
• Which apps inject scripts into your theme
• Any custom Liquid logic in templates
• Metafields you're using (if any)

This audit prevents surprises mid-migration.

Step 2: Choose Your OS 2.0 Theme

You have two paths:

1. Start fresh with a new OS 2.0 theme (Dawn, Sense, Craft, or a premium theme)
2. Rebuild your current theme in an OS 2.0 structure

For most brands, starting fresh with a custom build on top of Dawn is the fastest path. Dawn is MIT-licensed and clean.

Step 3: Recreate Custom Sections as App Blocks

Every custom section from your old theme needs to be rebuilt as an OS 2.0-compatible section or app block. This is the most time-intensive step — but it's also where the upgrade pays dividends.

Step 4: Migrate Content and Metafields

Your products, collections, and pages move automatically. Custom metafields may need to be re-mapped to your new template structure.

Step 5: QA on a Dev Store

Never migrate on a live store. Build and test everything on a Shopify development store first. Give it at least 2 weeks of testing before going live.

Common Mistakes to Avoid

1. Migrating without an audit You'll discover missing features after launch. Do the audit first.

2. Keeping your old theme "just in case" Shopify lets you switch themes, so the old one stays. But this creates confusion. Commit to the migration.

3. Ignoring mobile OS 2.0 is mobile-first. Test on real devices, not just browser resize.

4. Rushing the metafield setup Metafields are powerful but take planning. Map them before you start building sections that depend on them.

Is It Worth It?

Every client we've migrated has said yes. The speed of making changes, the ability to run experiments, and the reduced developer dependency pays for the migration cost within a few months.

If your team is currently filing developer tickets for simple homepage changes, that's your sign it's time to migrate.

Get a free audit →