> For the complete documentation index, see [llms.txt](https://crocode.gitbook.io/elemento-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://crocode.gitbook.io/elemento-docs/updating-the-theme.md).

# Updating the Theme

#### Before You Update

Shopify does not automatically transfer custom code changes (Liquid, CSS, JavaScript) or custom settings between theme versions. Before updating:

* **Back up your current theme** by duplicating it.
* **Document any custom code** or use a version control system (e.g., Git).
* **Test the new version** before publishing it live.

#### Step 1: Duplicate Your Current Theme

To create a backup:

1. In your Shopify admin, go to **Online Store → Themes**.
2. Locate your current *Elemento* theme.
3. Click **Actions → Duplicate**.
4. This will create a copy in your **Theme Library**.

#### Step 2: Install the New Theme Version

**Option A: From Shopify Theme Store**

1. Go to the **Shopify Theme Store**.
2. Search for *Elemento*.
3. Click **Add latest version**.
4. The updated version will be added to your **Theme Library**.

**Option B: Upload a ZIP File**

1. In your Shopify admin, go to **Online Store → Themes**.
2. Click **Add theme → Upload zip file**.
3. Select the `.zip` file of the new *Elemento* version and upload it.

#### Step 3: Reapply Customizations (If Applicable)

If you have made code customizations:

* Open both your old and new themes in the code editor.
* Manually migrate changes or use a theme diff tool to compare files.
* Pay attention to changes in `theme.liquid`, custom sections, or snippets.

If your changes were only made via the Theme Editor (Customizer), your settings will not automatically transfer. You can:

* Manually replicate the settings in the new version.
* Use third-party tools like the “Theme Settings Transfer” app (optional, not officially supported by Shopify).

#### Step 4: Preview and Publish the New Version

1. In **Theme Library**, click **Preview** next to the updated version to check it on your storefront.
2. If everything looks correct, click **Actions → Publish** to make the new version live.

***

#### Best Practice: Version Labeling

To stay organized, rename your duplicated and edited themes using version labels like:

* `Elemento v1.1.0 – Live`
* `Elemento v1.0.2 – Backup`
* `Elemento v1.2.0 – Customizing`