> For the complete documentation index, see [llms.txt](https://staylime.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://staylime.com/docs/avante-themes/faq/theme-setup/failed-to-load-the-page-in-shopify-theme-editor-how-to-fix.md).

# "Failed to load the page" in Shopify Theme Editor — how to fix

Fix the "Failed to load the page" error in the Shopify Theme Editor with the Avante theme. Common causes: Preload links on hover setting, VPN or proxy, multiple people editing at the same time.

The Shopify Theme Editor may show a "Failed to load the page" error with messages like "Page is redirecting to an unsupported URL" or "Page failed to load due to an error." This is not a theme bug — it's caused by the editor environment conflicting with certain browser or theme settings. Below are the three most common causes and how to fix each one.

<figure><img src="https://795663372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6DraMvJNYYlFJqlho1aV%2Fuploads%2FMD5lo61VSDLnYZ2vTNWO%2FGroup%202%20(42).jpg?alt=media&amp;token=45dd254c-71c5-49ca-b46b-9088cb2be4f1" alt=""><figcaption></figcaption></figure>

***

### Cause 1: "Preload links on hover" setting

The most common cause on older theme versions. Avante includes a performance feature that preloads pages when you hover over links — this speeds up navigation for your customers. The Shopify Theme Editor loads your store inside an iframe, and the preload script can redirect that iframe to an unsupported URL, crashing the editor.

{% hint style="success" icon="lightbulb" %}
**Note:** This was fixed in Avante v13.0.1 — since that version the preload script is switched off inside the Theme Editor, so it can no longer cause the error. If you are on v13 or later, go straight to Cause 2.
{% endhint %}

**Fix:**

{% stepper %}
{% step %}
Open your **Shopify Admin → Online Store → Themes**
{% endstep %}

{% step %}
Click **Edit theme** on your theme
{% endstep %}

{% step %}
If the editor loads — go to **Theme settings → Animation**
{% endstep %}

{% step %}
Uncheck **Preload links on hover**

<figure><img src="https://795663372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6DraMvJNYYlFJqlho1aV%2Fuploads%2F0GQSvZFZG9cm3ZSNJvcU%2FGroup%202%20(43).jpg?alt=media&amp;token=0f93c32c-c173-49f8-b3f2-1f4c3733251f" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Save**
{% endstep %}
{% endstepper %}

If the editor won't load at all, switch the setting off in the code instead:

{% stepper %}
{% step %}
Go to **Online Store → Themes → Actions → Edit code**

<figure><img src="https://795663372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6DraMvJNYYlFJqlho1aV%2Fuploads%2Fg4ozV97ijO5nkP3Pf33p%2FGroup%202%20(44).jpg?alt=media&amp;token=1b04b9f5-f8df-4a65-99a6-84d5770f6fe0" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Open `config/settings_data.json`
{% endstep %}

{% step %}
Search for `"preload_links"`. If you find it, change its value to `false`.

If it isn't there, find the line that reads `"current": {` near the top of the file and add this as a new line right under it:

{% code title="config/settings\_data.json" %}

```json
"preload_links": false,
```

{% endcode %}
{% endstep %}

{% step %}
Click **Save**
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Why the key may be missing:** `settings_data.json` only stores the settings that differ from the theme's defaults. Preloading is on by default, so on a store where nobody has touched it the key simply isn't written to the file yet — adding it is how you turn it off.
{% endhint %}

The Theme Editor will work immediately after this change. You can keep the setting off permanently — it only affects hover-based preloading and has no visible impact on your store's speed or functionality.

***

### Cause 2: VPN or proxy connection

A VPN can interfere with how Shopify loads the Theme Editor preview. The editor connects to your store URL inside an iframe — if the VPN redirects, blocks, or alters that connection, Shopify treats it as an unsupported URL redirect and shows the error.

**Fix:**

{% stepper %}
{% step %}
Disable your VPN or proxy
{% endstep %}

{% step %}
Reload the Theme Editor
{% endstep %}

{% step %}
If the editor loads, your VPN was the cause
{% endstep %}
{% endstepper %}

If you need a VPN for work, try switching to a server in the same region as your Shopify store, or add `*.myshopify.com` and `*.shopify.com` to your VPN's bypass/split-tunneling list.

***

### Cause 3: Multiple people editing at the same time

Shopify's Theme Editor does not fully support concurrent editing. If two or more people (or browser tabs) have the same theme open in the editor simultaneously, it can cause loading conflicts and trigger this error.

**Fix:**

{% stepper %}
{% step %}
Make sure no one else is working in the Theme Editor on the same theme
{% endstep %}

{% step %}
Close any other browser tabs that have the editor open
{% endstep %}

{% step %}
Reload the editor
{% endstep %}
{% endstepper %}

{% hint style="success" icon="sparkles" %}
**Tip:** If you're working with a developer or agency, coordinate editing sessions so only one person has the editor open at a time.
{% endhint %}

***

### Still seeing the error?

If none of the above resolves the issue:

1. Try a different browser or incognito/private window
2. Clear your browser cache
3. Check if your theme version is outdated — see [How to update your Shopify theme](https://staylime.com/docs/theme-management/how-to-update-your-shopify-theme.md)

If the problem persists, [contact our support team](https://staylime.zendesk.com/hc/en-us/requests/new) with your store URL and a screenshot of the error.

***

### Related

* [Troubleshooting guide](https://staylime.com/docs/theme-management/troubleshooting-guide.md)
* [How to update your Shopify theme](https://staylime.com/docs/theme-management/how-to-update-your-shopify-theme.md)
* [How to use the Shopify theme editor](https://staylime.com/docs/getting-started/how-to-use-the-shopify-theme-editor.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://staylime.com/docs/avante-themes/faq/theme-setup/failed-to-load-the-page-in-shopify-theme-editor-how-to-fix.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
