How to Update a Theme on Shopify

How to Update a Theme on Shopify

Updating your Shopify theme ensures you have the latest features, design improvements, and bug fixes. Here’s a step-by-step guide on how to update your theme, while keeping your customizations safe.

1. Check If an Update Is Available

  • Go to your Shopify admin.

  • Navigate to Online Store > Themes.

  • If an update is available for your theme (from the Shopify Theme Store), you’ll see a notification or an option to update.

2. Back Up Your Current Theme

Before making any changes, always back up your existing theme:

  • In the Themes section, click Actions > Duplicate to create a copy of your current theme.

  • Optionally, download the theme file for extra safety.

3. Add the Updated Theme Version

  • Click the update notification or Add to theme library. This will add the new version to your theme library without affecting your live site.

  • The new theme will be labeled as Updated copy of [Theme Name].

4. Review and Transfer Customizations

  • Theme Editor Changes: Most customizations made using the theme editor (settings, sections, templates, app embeds) are automatically copied to the new version.

  • Custom Code Changes: Manual code edits (in the code editor) are not transferred automatically. You’ll need to manually move these changes:

    • Use a code comparison tool (diff checker) to identify changes between your old and new theme files.

    • Copy over necessary code customizations, such as those in Liquid, CSS, or JavaScript files.

    • For settings, copy the contents of settings_data.json from your old theme’s Config folder to the new one if needed.

5. Test the Updated Theme

  • Preview the new theme in your theme library.

  • Check all customizations, app integrations, and storefront functionality to ensure everything works as expected.

6. Publish the Updated Theme

  • Once you’re satisfied, click Actions > Publish on the new theme to make it live.


Additional Tips

  • Third-Party Themes: If your theme was purchased outside the Shopify Theme Store, updates may not be available through the admin. You may need to manually install a new version and migrate your settings and customizations.

  • Theme Updater Apps: Some developers offer apps (like “Theme Updater” by Out of the Sandbox) to automate the update process and help transfer settings.

  • Compatibility: Some apps or customizations may not work with the new theme version. Test thoroughly before publishing.


Summary Table

Step
Action

Backup

Duplicate your theme in the admin

Add Update

Click update notification or add latest version from Theme Store

Transfer Custom Code

Manually move code changes (if any) using code comparison tools

Test

Preview and test all features and customizations

Publish

Make the updated theme live

Updating your Shopify theme is a safe process when you follow these steps, ensuring your store remains up-to-date without losing important customizations.

Last updated