# Migrating your settings

{% hint style="warning" %}
These steps are for merchants **already using Pipeline 6 and above**.&#x20;

If your store is running Pipeline 5 or earlier, migrating settings is not recommend. Due to the many performance improvements included in Shopify Online Store 2, legacy settings files will slow down your store load times. A fresh theme build is recommended when updating to the new Shopify OS2 platform.&#x20;
{% endhint %}

### Tips on updating your theme for Pipeline 6 and above

Pipeline 6 is designed for Shopify Online Store 2.0. For customers who are already using Pipeline 6 or above and also updating to a newer version, these tips will help you migrate your current shop settings and sections over to a newer version of Pipeline.\
\
Full video walkthrough on how to migrate your settings and sections:

{% embed url="<https://www.loom.com/share/c553b3e7f04e491090d2578249205df4>" %}
Tips to copy over all your settings and sections
{% endembed %}

**Steps covered in the video:**

* Making a duplicate of your live theme (required)
* Copy current Pipeline 6 settings to a newer version of Pipeline (example Pipeline 6.1.1)
* Copy all sections, blocks, and section settings (including homepage sections) from the current live theme to the newer version of Pipeline.

#### Additional notes to video (*New*):

1. We recommend you copy **all** JSON files from the Templates folder rather than only the ones with blue dots. The blue dots won't appear on copied themes and we have also seen the Shopify Code Editor to not place blue dots in some cases to files that have been changed. Our strong recommendation is to copy all .JSON files from the **templates** folder one-by-one to your new theme.&#x20;
2. If you experience an error when copying from a file and saving on the new theme, skip that file. This can occur when a setting value is not supported in a newer version. In this case, you can manually create the content in the Theme Editor. In some cases, you might be able to adjust in code to handle the setting change but we recommend you hire or use a developer to make those edits.

{% hint style="info" %}
Disclaimer\
The tips provided on this page and video are for advanced users, agencies, and Shopify Experts. Shopify does not currently have a system in place to update themes automatically. For that reason, we have provided these tips to help you. Our free theme support does **not** include copying these files for you. If you require assistance with updating themes, please consult a Shopify Expert. Remember to always make a duplicate of your live theme (covered in the video) before making any code changes in the Code Editor.&#x20;
{% endhint %}

### Reference from video

When copying over your sections, section blocks, and section settings, these are the JSON files listed in the Templates folder:

![Example .JSON files in the templates folder](/files/-Mjrzjty6wEeR6klIrl2)

The blue dot next to the filename indicates the file has been modified or updated which also means you will need to copy all the code from that file to your new theme version. These JSON files store all your sections, section blocks, and section settings when using Shopify Online Store 2.0. We recommend you copy **ALL** .JSON files with, or without a blue dot from the **templates folder** over to the new theme.&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://pipeline.groupthought.com/faq/frequently-asked-questions/migrating-your-settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
