How To Update A Shopify Theme

You see the “Update available” badge on your Shopify theme. You click it. Shopify tells you a new version is ready. What it doesn’t tell you: any custom code you’ve added to the theme files will be gone the moment you apply the update. That includes tracking pixels added directly to theme.liquid, custom Liquid snippets, app-injected code that your apps never cleaned up, and any CSS or JavaScript a developer dropped into your files. This guide covers the full update process, including the part most guides skip: how to find your custom code before the update, and how to get it back after.

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.

Updating the Dawn Theme (Shopify’s Default)

Dawn is Shopify’s free flagship theme and the one most stores start on. It gets updated more frequently than paid themes, so if you’re running Dawn, you’ll see update notifications more often than most.

How to Check Your Dawn Version

Go to Online Store > Themes, click the three-dot menu on Dawn, and select Edit code. Open the file config/settings_schema.json. Near the top you’ll see a “theme_info” block with a “theme_version” field. That number is your current Dawn version.

Alternatively: if you see an “Update available” badge on the theme card, Shopify usually shows the version number in the update notification modal.

What Changes Between Dawn Versions

Dawn updates tend to fall into a few categories:

• Performance improvements. Shopify’s team regularly trims JavaScript weight and optimizes image loading. These are usually safe and worth taking.
• New section types or section settings. Shopify may add new layout blocks or configuration options to existing sections. Your current sections keep working; you just get new options in the editor.
• Checkout and cart changes. Dawn occasionally updates how the cart drawer works or how the checkout link renders. These can affect app integrations with the cart.
• Accessibility fixes. Dawn is Shopify’s reference theme for accessibility compliance. Updates sometimes fix ARIA labels, keyboard navigation, or color contrast.

Do Theme Editor Settings Carry Over for Dawn?

Yes, for the most part. When you update a Shopify Theme Store theme like Dawn, Shopify transfers your theme editor settings (colors, typography, section layout on each page, image uploads) to the updated version. You should still verify everything after updating, because occasionally a new version changes a setting name or moves a control.

What doesn’t carry over: any direct edits you’ve made to Dawn’s .liquid files. If you or a developer modified sections/header.liquid, layout/theme.liquid, or any snippet files, those changes are gone when you apply the update. This is the main reason to back up and document your code before updating, even on a “simple” theme like Dawn.

Dawn-Specific Update Tip

Dawn versions jump significantly with major Shopify platform releases. Going from Dawn 10.x to Dawn 14.x, for example, involves real structural changes. For those larger jumps, don’t just hit “Update” and publish immediately. Apply the update to an unpublished copy, test every page type, then publish. Treat it like a small project rather than a one-click fix.

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.

How to Update a Shopify Theme Without Losing Your Code

Most guides tell you to “duplicate first” and “document your changes.” That’s fine as far as it goes. What they don’t explain is how to actually find your custom code after the fact, and how to move it into the updated theme file by file. Here’s the systematic approach.

Step 1: Identify Which Files You’ve Actually Edited

Don’t assume you remember every file you touched. Use the Shopify code editor’s file list to check modification dates:

1. Open your backup (duplicated) theme in Edit code.
2. Work through each folder: Layout, Templates, Sections, Snippets, Assets, Config, Locales.
3. Look for files you recognize changing. Common locations for custom edits: layout/theme.liquid (tracking pixels, global scripts), sections/header.liquid (nav customizations), snippets/ (any custom snippet files you created), assets/custom.css or assets/theme.css (custom CSS), and config/settings_data.json (theme editor settings).

If a developer did the work, ask them for a list of files changed. If they’re no longer available, compare your backup against a fresh download of the same theme version to spot the differences.

Step 2: Compare Old vs New Files Side by Side

With both the backup and the updated theme open in the code editor (two browser tabs), go to the first file you know was edited:

1. Open the file in the backup theme. Select all the code. Copy it to a text editor (VS Code, Notepad, TextEdit).
2. Open the same file in the updated theme. Copy that version to a second tab in your text editor.
3. Use your text editor’s “compare files” or diff feature to see exactly what changed between the two versions. In VS Code: open both files, right-click one tab, choose “Select for Compare,” then right-click the other and choose “Compare with Selected.”

The diff shows you two things: what the theme developer changed (their update), and what you changed (your customizations). Your job is to take your customizations and apply them on top of the updated file, without accidentally reverting the developer’s new code.

Step 3: Re-Apply Your Changes Carefully

For each file with custom edits:

• Tracking pixels and scripts: These usually live in a clearly marked block (look for a comment like “Google Analytics” or “Meta Pixel”). In the updated file, find the same location (usually just before or just before ) and paste your script there.
• Custom CSS: If you added CSS in the code editor (not through the theme settings), it usually lives in a custom section at the bottom of the CSS file or in a separate assets/custom.css file. Paste it in the same location in the updated theme.
• Custom Liquid logic: This is the trickiest part. If the developer restructured the file in their update, your code might not drop in at the same line number. Read the surrounding context in the updated file to find the right insertion point. Look for the same HTML structure or Liquid tag block you were modifying before.
• App snippets: If an app added a {% render ‘app-snippet’ %} call to your theme files, check whether the app automatically re-injects its snippet when you reinstall it. Many do. For those that don’t, find the render call in your backup and add it to the corresponding location in the updated theme.

What to Do When the File Structure Changed

Major version updates sometimes reorganize the file structure. A section that was one file may now be split into multiple files, or a snippet that was separate may be merged inline. When this happens:

• Read the theme developer’s release notes or changelog. They usually call out structural changes explicitly.
• Search the updated theme’s codebase for the unique HTML elements or CSS class names you were customizing. That tells you where the equivalent code lives in the new version.
• If you were customizing a specific feature (like the cart drawer or the product variant selector), look for the section file named after that feature in the Sections folder of the updated theme.

Going through this process file by file takes longer than just clicking “update,” but it’s the only way to keep your custom code intact and know exactly what’s in your live theme.

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.

How Often Should You Update Your Shopify Theme?

There’s no fixed schedule, but a practical cadence keeps you current without churning your store every month. Use this as a rule of thumb:

• Check for updates quarterly. Shopify Theme Store themes get minor releases every few months. Open your theme in the admin and look for the “Update available” badge once a quarter.
• Apply minor updates within a month of release. These are usually bug fixes and small accessibility or speed improvements: low risk and worth taking.
• Plan major version updates deliberately. A jump like Dawn 10.x to 15.x can change section structure. Treat it as a small project: duplicate, update the copy, re-apply customizations, test, then publish.
• Always update before a big traffic event. Two to three weeks before BFCM or a product launch, take the current update so you’re not patching live during peak sales. Never update the day of a launch.
• Update immediately for security or checkout-related patches. If Shopify flags a theme update as fixing a checkout or security issue, don’t wait for the quarterly cycle.

One caveat: if your theme is heavily custom-coded by a developer, frequent updates can overwrite that work. In that case, coordinate with whoever maintains the code and update on their schedule, not the store’s.

Pre-Update Checklist (Run This Every Time)

Before you click “update,” walk through this short checklist. It takes five minutes and prevents the most common post-update headaches:

• Duplicate the current live theme (Online Store > Themes > Actions > Duplicate) so you have a one-click rollback.
• Screenshot your homepage, a collection page, a product page, and the cart on both desktop and mobile.
• Export or copy any custom code from theme.liquid, custom CSS, and any custom sections or snippets.
• Note every app that injects code into the theme (review apps, upsell apps, page builders). These are the things most likely to break.
• List your active theme settings (colors, fonts, section order) in case the update resets any defaults.
• Pick a low-traffic window to publish: not a Friday afternoon.

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 is 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 is usually preserved, since it’s stored separately from the theme files. Verify after updating.

Theme Update Failed? Common Errors and Fixes

Sometimes the update process itself runs into problems. Here are the most common ones and what to do about each.

“Update Available” Badge Not Showing

You’ve heard a new version of your theme is out, but you don’t see any update notification in the admin. A few causes:

• Your theme is already on the latest version. Shopify only shows the badge when there’s actually a newer version. Double-check by opening the code editor and looking at the version number in config/settings_schema.json, then comparing it to the developer’s changelog.
• You’re not using the original theme from the Theme Store. If you bought the theme, received a ZIP file from a developer, or your agency uploaded a customized version, Shopify has no way to know what “version” you’re on. It won’t show update notifications for themes not connected to the Theme Store record.
• You’re looking at the wrong theme. Make sure you’re checking the theme card for your active (published) theme. Update badges appear on the active theme card, not on unpublished copies in your library.
• Cache or session issue. Try a hard refresh (Cmd+Shift+R on Mac, Ctrl+Shift+R on PC) or open the Shopify admin in an incognito window to rule out a cached view.

“Theme Is Up to Date” Message When You Know It Isn’t

This usually means one of two things: either the update hasn’t been pushed to all stores yet (Shopify sometimes rolls updates out gradually), or the theme file connected to your store’s Theme Store record was modified outside the standard update flow. In the second case, Shopify can’t safely determine whether your version is “older” or “newer.” Contact Theme Store support with your theme name and your current version number. They can manually trigger the update or confirm whether one is actually available.

The Update Applied But Something Immediately Broke

Don’t panic. The most important thing here is that you have your backup.

1. If the breakage is serious (checkout broken, site down): Go to Online Store > Themes, find your backup (“Copy of [theme name]”), click the three-dot menu, and select Publish. You’re back to your pre-update state in under a minute.
2. If the breakage is cosmetic or minor: Stay on the updated theme and fix the specific issue. Open the code editor on the updated theme, find the file responsible, and compare it against your backup to see what’s different.
3. If a specific app stopped working: Uninstall and reinstall the app. Most app integrations use a “theme app extension” system that re-injects automatically on reinstall. For older apps that rely on manual code injection, go to the app’s settings page and look for a “re-setup” or “reconnect theme” option.

Update Button Is Greyed Out or Unclickable

This sometimes happens when Shopify is still processing the previous update action, or when there’s a temporary sync issue between your store and the Theme Store. Steps to try:

• Wait 10-15 minutes and refresh the page.
• Log out of Shopify and log back in.
• If the button is still stuck after an hour, contact Shopify support directly with your store URL and theme name. This is a known intermittent bug that typically resolves on the backend without any action on your part.

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.