# Upgrading your Shopify Theme

> Learn how to successfully upgrade your theme that contains Section Star and other custom sections.

URL: https://sectionstar.app/docs/upgrading-theme/
Source: Section Star — https://sectionstar.app
Updated: 2026-10-26T00:00:21.825Z

---

Upgrading your theme should be easy, right?! Well, there is a long (really long) standing bug in Shopify that prevents **custom sections** from getting updated along with all the sections built into your theme. Section Star sections fall under this **custom sections** definition. So, it does require a few extra steps to update your theme.

But, the good news is that updating your theme can be done relatively easily in just a few steps.

## 1. Update your theme following the normal Shopify process

Goto Online Store > Themes and look for the link that says a new version is available. Then choose Add to theme library.

![alt text](</screenshots/CleanShot 2024-08-09 at 08.57.12@2x.png>)

## 2. Navigate to your code and validate that all the custom sections have been copied over

Open code from your current theme and the updated theme in separate tabs. Now, simply validate all the sections are there. All Section Star sections start with the sp- prefix. So, they are easy to locate. If a section is missing, simply copy it from one theme to the other. The easiest way to do this is by selecting Add a New Section under sections/ and then copy and pasting from one file to another. 

It is important to copy and paste the sections rather than installing them from Section Star because our sections periodically get updated and could effect step #3.

![alt text](</screenshots/CleanShot 2024-08-09 at 08.58.02@2x.png>) 

## 3. Copy over the configuration files

Now under the templates/ folder, you  need to copy and paste the JSON content from each template that has custom sections. Once again, copy and paste is the best way to do this.

![alt text](</screenshots/CleanShot 2024-08-09 at 08.58.48@2x.png>)

## 4. Report the bug to Shopify support

Shopify development is driven by user feedback. If enough of you ask them to fix this bug, it will get done. So, I encourage you to reach out to Shopify support and file a bug report.
