How To Update A Shopify Theme

Updating a Shopify theme means moving to a newer version of the same theme - preserving your settings, fonts, colors, and most layout choices, while picking up the developer’s latest fixes and features. The danger is custom Liquid code: any direct edits to .liquid files get overwritten when you update, which is why every Shopify theme update should start with a duplicate-and-backup step. This guide walks through the full process, including the lesser-covered question of when updating is the wrong move and you should actually switch themes (especially if you’re on a legacy Vintage theme and Shopify has been nudging you toward OS 2.0).

Why Shopify Themes Need Updating

Theme developers release updates for three main reasons, and all of them affect your store directly.

Security patches. Outdated code is the most common way stores get compromised. When a theme developer finds a vulnerability, the fix goes out in an update. If you’re running an old version, you’re exposed.

Bug fixes and compatibility. Shopify regularly updates its platform - new checkout features, updated APIs, changes to how sections work. Theme developers push updates so their themes stay compatible. Skip too many updates and you’ll start seeing things break, especially with apps that rely on theme integration.

New features and performance improvements. Updates often include speed optimizations, new section types, better mobile layouts, or support for Shopify’s latest features like predictive search or enhanced filtering. These are the updates that actually make your store better, not just keep it running.

A good rule of thumb: if an update is available, apply it. The longer you wait, the bigger the gap between your version and the current one, and the harder it gets to update without issues.

Vintage Themes vs OS 2.0: Update or Switch?

This is the question most store owners don’t realize they need to ask before clicking “update.” Shopify’s theme architecture changed in 2021 with the launch of Online Store 2.0 (OS 2.0). Themes from the original Theme Store era are now called “Vintage” themes - and the upgrade path from Vintage to OS 2.0 isn’t an “update,” it’s effectively a switch.

You’re on a Vintage theme if: you bought your theme before 2021, your theme name doesn’t appear in the current Shopify Theme Store catalog, or your sections-based customization is limited to the homepage (not product, collection, or other pages).

You’re on an OS 2.0 theme if: you can add and rearrange sections on every page type (homepage, product page, collection page, blog post, and more), and the theme uses JSON templates rather than .liquid templates for layout.

For Vintage themes, the developer may still be releasing security patches, but no new features. Most Vintage themes have an OS 2.0 equivalent - Shopify and the original developers usually built one. Migrating to the OS 2.0 version is closer to switching themes than updating, because the file structure is fundamentally different. You’ll set up sections again, re-upload settings, and likely re-apply any custom code from scratch.

Practical decision: if you’re on a Vintage theme and the developer offers an OS 2.0 version, plan a proper migration project (allocate 1-2 days minimum, more if you have heavy customizations). If they don’t, this is a real “switch themes” decision - see our roundup of the best Shopify themes for current OS 2.0 options.

How To Check for Theme Updates

Shopify makes this straightforward if your theme came from the Shopify Theme Store.

For Shopify Theme Store Themes

1. Log in to your Shopify admin and go to Online Store > Themes.
2. If an update is available for your active theme, you’ll see a notification banner at the top of the page or a badge next to the theme name.
3. Click the notification to review what’s included in the update - Shopify shows release notes so you can see what changed.

Shopify checks for updates automatically. You don’t need to do anything special to trigger the check. If there’s no notification, your theme is current.

For Third-Party Themes

If you bought your theme outside the Shopify Theme Store (from ThemeForest, Out of the Sandbox, Pixel Union, etc.), Shopify won’t notify you about updates. You’ll need to:

• Check the theme developer’s website or dashboard for new versions
• Sign up for their email list or changelog notifications
• Some developers offer update notification apps you can install in your store

Third-party themes usually come with documentation explaining their specific update process. Follow that rather than the generic Shopify flow.

Step-by-Step: How To Update Your Shopify Theme

Step 1: Back Up Your Current Theme

This is the most important step, and the one most people skip. If anything goes wrong with the update, your backup is how you get back to a working store in minutes instead of hours.

1. Go to Online Store > Themes in your Shopify admin.
2. Find your active theme and click the three-dot menu (…).
3. Select Duplicate.
4. Wait for the copy to appear in your theme library - it will show as “Copy of [your theme name].”

This duplicate is an exact copy of your current theme with all your customizations intact. If the update causes problems, you can publish this backup to restore your store immediately.

Extra precaution: If you’ve added custom Liquid code, also download your theme files. Go to the three-dot menu and select Download theme file. This gives you a local ZIP backup you can re-upload if needed. For more on what’s customizable, see our guide on how to customize a Shopify theme.

Step 2: Document Your Customizations

Before you apply the update, take stock of what you’ve changed. This is especially important if you’ve made changes beyond the theme editor:

• Custom Liquid code - Note which files you edited (theme.liquid, product.liquid, header sections, etc.) and what the changes do
• App-injected code - Some apps add code snippets to your theme files. Write down which apps modified your theme
• Custom CSS - Copy any custom CSS you added through the theme editor or directly in the code
• Third-party tracking scripts - Google Analytics, Facebook Pixel, or other scripts added to theme files

Take screenshots of your homepage, product pages, and collection pages. After the update, you’ll compare these to make sure everything still looks right.

Step 3: Apply the Update

For Shopify Theme Store themes:

1. Go to Online Store > Themes.
2. Click the update notification on your active theme.
3. Shopify will add the updated version to your theme library as a new, unpublished theme.
4. The updated theme keeps your theme editor settings (colors, fonts, section layouts). However, any direct code edits are not carried over.

For third-party themes:

1. Download the latest version from the developer’s website.
2. In your Shopify admin, go to Online Store > Themes.
3. Click Add theme > Upload ZIP file and upload the new version.
4. The new theme appears unpublished in your theme library.

Don’t publish the updated theme yet. You need to customize and test it first.

Step 4: Re-Apply Custom Code

If you had custom Liquid edits, app-injected code, or tracking scripts, you need to add them back to the updated theme. Open both the backup (duplicate) and the updated theme in separate browser tabs using the code editor:

1. Click the three-dot menu on each theme and select Edit code.
2. Compare the files side by side.
3. Copy your custom code from the backup theme into the matching files in the updated theme.
4. For app-injected code, it’s often easier to uninstall and reinstall the app - many apps re-inject their code automatically.

Be careful here. If the developer restructured files in the update, your old custom code might not fit in the same place. Check the developer’s release notes for any file structure changes.

Step 5: Customize the Updated Theme

Open the updated theme in the theme editor (Customize button) and verify your settings:

• Upload your logo if it didn’t carry over
• Check your color scheme and typography settings
• Review each section on your homepage, product pages, and collection pages
• Make sure your navigation menus are connected

Most theme editor settings transfer automatically for Shopify Theme Store themes. For third-party themes, you may need to reconfigure more manually.

Step 6: Test Before Publishing

Preview the updated theme thoroughly before making it live. Use the Preview button to browse your store as a customer would.

Check these critical areas:

• Homepage - All sections loading correctly, images displaying, slideshow working
• Product pages - Variant selectors, add-to-cart button, product images, reviews
• Cart and checkout - Add a product, go through the checkout flow (you can stop before payment)
• Navigation - All menu links working, dropdown menus functioning, mobile menu opening
• Mobile view - Resize your browser or check on your phone. Mobile layout issues are the most commonly missed problem after updates
• Speed - Does the store feel slower? Run a quick PageSpeed Insights test on the preview URL

Step 7: Publish the Updated Theme

Once you’re satisfied everything works:

1. Go to Online Store > Themes.
2. Find the updated theme in your theme library.
3. Click the three-dot menu and select Publish.
4. Confirm the publish action.

Your old theme moves to the unpublished section automatically. Keep it there for at least a week as a fallback.

Common Things That Break After a Shopify Theme Update

Even with a careful process, certain things break often enough to be worth checking specifically. The pattern across most reported issues:

• Cart drawer or mini-cart broken. Apps that customize the cart drawer (free-shipping bar, gift-with-purchase, upsell apps) often inject code into specific cart files. Updates can move or rename those files. Fix: reinstall the app, or contact the app’s support to reapply the integration.
• Free-shipping progress bar missing. Same pattern - apps tied to the cart inject code that gets overwritten.
• Product variant selector looks different. Theme developers occasionally change how variant pickers render (dropdown vs swatch vs button). If your old theme had a custom variant picker layout, it may revert to the default after update. Adjust in theme editor settings.
• Custom homepage sections gone. If a theme update removed or renamed a section type your homepage used, that section disappears. The fallback section will show; you’ll need to rebuild manually.
• Tracking pixels not firing. If you added Google Analytics, Meta Pixel, or other tracking via direct code edits to theme.liquid, those edits are gone. Verify pixel firing in the browser dev tools or with Tag Assistant.
• Schema markup missing or duplicated. Some apps add their own JSON-LD product schema; some themes do too. After an update you can end up with schema either missing or duplicated. Check Google’s Rich Results Test on a product page.
• Speed score drops. Updated themes sometimes ship with new features that add JavaScript weight. Run PageSpeed Insights before and after.

Walk through this checklist on the duplicate (preview) theme before publishing. Catching any of these in preview is 5 minutes; catching them in production is a customer-facing outage.

When NOT to Update Your Shopify Theme

Sometimes the right move is to wait. Don’t update right before or during:

• An active sale or promotion. Theme updates can introduce bugs, and a bug during BFCM costs real money. Update on slow days, never during a peak.
• The first 2 weeks after a major Shopify platform update. Theme developers usually push fixes within 1-2 weeks of a Shopify platform release as bugs surface in the field. Wait for the dust to settle.
• If your store has heavy custom code you no longer have documentation for. If a developer customized your theme heavily and you don’t have access to them anymore, an update can mean dozens of hours of unplanned re-work. Consider whether the security/feature gain is worth it, or whether a full theme switch is overdue.
• If you’re about to launch a new product or campaign. Don’t introduce theme variability into a launch week. Update after.
• If your traffic is paid and pixel-dependent. Some updates affect how tracking pixels load. If you’re spending significantly on Meta or Google ads, update on a low-traffic day so you can verify pixels fire correctly before the next ad-budget peak.

What Happens to Your Customizations During an Update

This is the question every store owner asks, and the answer depends on what kind of customizations you’re talking about.

Theme editor settings (colors, fonts, section layout, uploaded images) - these are usually preserved when updating a Shopify Theme Store theme. Shopify handles the migration of these settings.

Direct code edits (changes to .liquid files, custom Liquid sections, modified templates) - these are not preserved. The update replaces the theme code files with the new version. Any code you added or changed is overwritten. This is why the backup step is critical.

App-injected code - also lost during the update. Most apps can re-inject their code when you reinstall them, but some require manual setup.

Custom CSS added through the theme editor - usually preserved, since it’s stored separately from the theme files. But verify after updating.

Updating vs. Switching Themes

Updating and switching are different things, and it’s worth understanding the distinction.

Updating means moving to a newer version of the same theme you’re already using. Your settings mostly carry over, and the look of your store stays consistent. This is routine maintenance.

Switching means changing to a completely different theme. Nothing carries over automatically - you’re starting fresh with layout, settings, and any custom code. This is a bigger project that requires planning.

If your current theme still meets your needs and the developer actively maintains it, update. If the developer has stopped updating the theme, or if your business needs have outgrown what the theme can do, that’s when you consider switching.