Complete Guide to Migrating to Shopify OS 2.0

Online Store 2.0 (OS 2.0) represents a major architectural shift in Shopify themes. If you're still on a legacy theme, migrating to OS 2.0 unlocks better performance, more flexibility, and future-proofing. This guide walks you through the process.

What is Online Store 2.0?

OS 2.0 is Shopify's modern theme architecture, introduced in 2021. It includes:

• Sections everywhere - Add sections to any page, not just homepage
• App blocks - Apps integrate directly into sections
• JSON templates - Flexible page templates
• Metafields - Native custom fields for products, collections, etc.
• Better performance - Modern codebase optimizations

Is Your Theme OS 2.0?

Check if your theme is OS 2.0:

1. Go to Online Store → Themes
2. Click Actions → Edit code
3. Look in the Templates folder
4. If templates end in .json = OS 2.0
5. If templates end in .liquid = Legacy

Why Migrate to OS 2.0?

Performance Benefits

• Faster page loads
• Better Core Web Vitals
• Improved mobile experience

Flexibility Benefits

• Add sections to any page
• Create custom templates without code
• More theme customization options

Future-Proofing

• New Shopify features target OS 2.0
• Better app compatibility
• Continued support and updates

Developer Benefits

• Cleaner codebase
• Better separation of concerns
• Easier maintenance

Migration Options

Option 1: Switch to a New OS 2.0 Theme

Recommended for: Most stores

Process:

1. Choose an OS 2.0 theme (Dawn, Prestige, etc.)
2. Set up the new theme
3. Migrate content and settings
4. Test thoroughly
5. Launch

Pros: Clean start, best performance Cons: Need to recreate customizations

Option 2: Upgrade Existing Theme

Recommended for: Stores with heavy customizations

Process:

1. Duplicate your theme
2. Convert templates to JSON
3. Update sections for OS 2.0
4. Test and fix issues
5. Launch

Pros: Keeps customizations Cons: Complex, may miss some benefits

Option 3: Hire a Developer

Recommended for: Complex stores, limited technical skills

Process:

1. Find a Shopify Expert
2. Document requirements
3. Supervise migration
4. Test and launch

Pros: Professional result Cons: Cost, timeline dependent on availability

Planning Your Migration

Step 1: Audit Current Theme

Document everything in your current theme:

Pages and templates:

• Homepage sections and layout
• Product page features
• Collection page setup
• Other custom pages

Customizations:

• Code modifications
• Custom CSS
• Third-party scripts

Apps:

• Which apps modify the theme?
• Are they OS 2.0 compatible?

Step 2: Choose Target Theme

For most stores, we recommend starting with Dawn or a premium OS 2.0 theme like Prestige.

Considerations:

• Feature requirements
• Design preferences
• Performance needs
• Budget

Use our Theme Recommender for personalized suggestions.

Step 3: Plan Content Migration

List content that needs to migrate:

• Homepage layout and content
• Navigation menus
• Product descriptions and images
• Collection descriptions
• Page content
• Blog posts
• Customer reviews
• Metafield data

Step 4: Timeline and Testing

Create a realistic timeline:

Executing the Migration

Setting Up New Theme

1. Install theme from Shopify Theme Store
2. Create backup of current theme
3. Set up staging - Don't publish yet

Migrating Content

Navigation:

• Recreate menus in new theme
• Check link structure

Homepage:

• Rebuild using OS 2.0 sections
• Match layout as closely as needed
• Add new features where beneficial

Product Pages:

• Configure product sections
• Set up metafields if needed
• Test variant display

Collection Pages:

• Configure filtering
• Set up sorting options
• Check pagination

Handling Customizations

For code customizations:

• Identify which are still needed
• Adapt code for OS 2.0 structure
• Test thoroughly

For apps:

• Check OS 2.0 compatibility
• Update app blocks where available
• Contact app developers if issues

Testing Your Migration

Functional Testing

Test every page type:

• Homepage
• Product pages (multiple products)
• Collection pages
• Cart page
• Checkout (test order)
• Account pages
• Search
• 404 page

Performance Testing

Compare before and after:

• PageSpeed Insights scores
• Core Web Vitals
• Mobile performance

Cross-Browser Testing

Test on:

• Chrome
• Safari
• Firefox
• Edge
• iOS Safari
• Android Chrome

Device Testing

Test on:

• Desktop
• Tablet
• Mobile

Launch Checklist

Before going live:

• All content migrated
• All pages tested
• Forms working
• Analytics connected
• Apps functioning
• SEO elements in place (titles, meta descriptions)
• Redirects set up if URLs changed
• SSL working
• Backup of old theme saved

Post-Migration

Monitor Performance

Watch for issues in the first week:

• Check Google Search Console
• Monitor conversion rates
• Review customer feedback
• Watch for broken links

Optimize Further

Now that you're on OS 2.0:

• Explore new section possibilities
• Try app blocks
• Use metafields for custom data
• Consider additional optimizations

Common Migration Issues

Issue: Missing Features

Solution: Check theme documentation, may need alternative approach or app

Issue: Broken Apps

Solution: Update to OS 2.0 compatible versions, contact developers

Issue: Layout Differences

Solution: Use OS 2.0 flexibility to recreate, may need custom sections

Issue: Performance Regression

Solution: Audit new setup, check for heavy apps or unoptimized images

Next Steps

• Use our Migration Simulator to preview outcomes
• Check our Migration Checklist
• Browse Dawn migration guide for specifics