# Update Pebble theme

Keeping your **Pebble theme** up to date ensures your store benefits from the latest features, bug fixes, and compatibility improvements.

> The most up-to-date version of the theme is available on Shopify Theme Store. 

{% hint style="danger" %}
Any **code customizations** in your current theme are **not transferred automatically** to a new theme version. 

You’ll need to manually duplicate and move custom code to the updated theme.
{% endhint %}

***

### Update the theme automatically ⚙️

{% stepper %}
{% step %}

#### Check notifications on Shopify

In your Shopify admin, go to **Online Store** > **Themes**. If a new version of Pebble is available, you’ll see a notification in your theme library.

<figure><img src="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FwD6X4HG335vwMuuJeS6v%2Fimage.png?alt=media&#x26;token=0dd073e0-c623-4a7a-8c6c-1d310577818e" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Review update details

* Click the notification to view more details about the update.
* Select **View release notes** to read what’s new in the release.
  {% endstep %}

{% step %}

#### Add to Theme library

Click **Add to theme library** to download and add the updated version of the theme to your Shopify store.

The updated version will now appear in your theme library, ready to customize and publish.
{% endstep %}
{% endstepper %}

### Troubleshooting: No update notification? 🔍

If you don’t see an update notification, it could be due to code customizations conflicting with Shopify’s update system, or the theme was previously uploaded in a ZIP file. In this case, you can manually reinstall the theme and transfer the customization manually.

{% stepper %}
{% step %}

#### Preparing for the update: Create a backup&#x20;

Before updating your theme, always duplicate your current theme to create a **backup**. This ensures you can restore your store if something goes wrong.

{% hint style="success" %}
**Steps:**

1. In your Shopify admi&#x6E;**,** go to **Online store** > **Themes.**
2. Under the Actions dropdown for your current theme, select **Duplicate**.
3. Rename the duplicated file.
   {% endhint %}
   {% endstep %}

{% step %}

#### Install the latest theme version

Install the theme from the Shopify Theme Store.

{% hint style="success" %}
**Steps:**

1. Visit the Shopify Theme Store and choose **Pebble** them&#x65;**.**
2. Click **Add a new copy** to add the latest theme version to your online store.
   {% endhint %}
   {% endstep %}

{% step %}

#### Move the theme settings and pages

After uploading the new theme, transfer your settings, custom templates, and modifications to the new version.

{% hint style="success" %}
**Steps:**

1. Go to your current theme, click **Actions > Edit code**.
2. Copy the following files from the **old theme** and paste them into the same folders in the **new version**:
   * All edited **JSON files** in the `Templates` folder.
   * The `settings_data.json` file in the `Config` folder.
3. Re-create custom templates (if any).
   {% endhint %}

<figure><img src="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FLhhWdRzFWuFV5TA7MQdA%2Fimage.png?alt=media&#x26;token=a1923221-1e18-401f-bc36-43e1ba3f616c" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
For custom templates, you'll need to create the JSON template in the new theme files since they won't exist there by default. More details [here](https://help.shopify.com/manual/online-store/themes/theme-structure/templates#create-a-new-template) from Shopify on creating new templates in the theme.
{% endhint %}
{% endstep %}

{% step %}

#### Re-install apps <a href="#h_01f688nf9yn2g76wb9kxarp7e7" id="h_01f688nf9yn2g76wb9kxarp7e7"></a>

Any apps that add code to your theme's files will need to be reinstalled. This can be an automatic or manual process depending on the app, so **confirm with the app's developer whether removing and adding the app is enough to connect with the new version.**

{% hint style="info" %}
Find the app documentation in the [App Store](https://apps.shopify.com/) to follow the installation instructions.&#x20;

If you're unfamiliar with this process, you can go to **Apps >** click **View details** to find the support email for that Shopify app.
{% endhint %}
{% endstep %}
{% endstepper %}