> For the complete documentation index, see [llms.txt](https://docs.turboload.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.turboload.ai/getting-started/theme-extension-setup.md).

# Theme Extension Setup

> **Fast, Zero-Impact Setup:** Activate TurboLoad in under 60 seconds directly inside your Shopify Theme Editor without writing a single line of code.

To enable real-world performance monitoring, slow-app attribution, and automated script deferral on your store, activate the **TurboLoad Theme App Extension** in your published Shopify theme.

![TurboLoad Theme App Extension setup showing Monitor and Optimizer embed block activation in Shopify Theme Editor](https://3104101331-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4kkyKWXlRlIIrT0xXLUz%2Fuploads%2Fgit-blob-a61d5f6530c179cd7dfd674ce7ef1f6fe9a7e6d9%2F10_theme_extension.png?alt=media)

Shopify Theme App Extensions are the modern, secure standard for adding app functionality to your storefront. They inject zero permanent code into your Liquid files, guaranteeing that your theme remains pristine and conflict-free.

***

## Direct Answer: How do I activate TurboLoad on my Shopify theme?

To activate TurboLoad, go to **Shopify Admin → Online Store → Themes → Customize**, click the **App Embeds** tab on the left menu, toggle **TurboLoad Monitor** and **TurboLoad Optimizer** to **ON**, and click **Save**. TurboLoad will immediately begin monitoring storefront performance and applying active optimizations without affecting shopper experience.

***

## App Embed Blocks Overview

TurboLoad provides two complementary theme app embeds:

1. **TurboLoad Monitor (Core / Telemetry):**\
   Measures third-party app script execution, long tasks, and resource delivery times without affecting shopper speed.
2. **TurboLoad Optimizer (Optimization / Acceleration):**\
   Enables intelligent deferral of non-critical third-party marketing scripts, image preconnecting, and critical asset preloading.

***

## Step-by-Step Activation Procedure

Follow these 4 simple steps to enable TurboLoad on your store:

### Step 1: Navigate to the Shopify Theme Editor

From your Shopify Admin dashboard:

1. Go to **Online Store → Themes**.
2. Locate your **Current (Published) Theme**.
3. Click the **Customize** button.

### Step 2: Open the App Embeds Panel

1. In the left-hand sidebar of the Theme Editor, click on the **App Embeds** icon (the third icon down, representing a modular puzzle block).

### Step 3: Enable TurboLoad Embeds

1. Search for **TurboLoad** in the app embeds search bar.
2. Toggle **TurboLoad Monitor** to the **ON** position.
3. Toggle **TurboLoad Optimizer** to the **ON** position (recommended for script deferral and speed gains).

### Step 4: Save Changes

1. Click the green **Save** button in the top right corner of the Theme Editor.

{% hint style="success" %}
**Instant Verification:**\
Once saved, return to **Apps → TurboLoad**. The status badge on your dashboard will update to `Theme Extension: Active`.
{% endhint %}

***

## Frequently Asked Questions

### Why does TurboLoad show "Theme Extension: Inactive"?

* **Unpublished Draft Theme:** Ensure you activated the embed on your **currently published theme**, not an inactive draft theme.
* **Cache Refresh:** It may take 1–2 minutes for the initial shopper beacon to register after enabling the embed. Open your storefront in an incognito browser window and refresh once.

### Will the theme extension slow down my store?

No. TurboLoad adheres strictly to Shopify's highest performance standards:

* **Ultra-Lightweight:** Both scripts are heavily compressed (combined under 6KB) so they consume virtually zero mobile bandwidth.
* **Asynchronous & Non-Blocking:** Scripts execute passively and never block DOM construction, customer clicks, or checkout rendering.

***

## Developer & Agency Note: Zero Residual Footprint

TurboLoad uses native Shopify App Embed technology exclusively:

* **No Liquid Contamination:** No custom snippets or hardcoded script tags are written into your theme templates.
* **Clean Disconnect:** Disabling or uninstalling the app immediately removes all script references without requiring manual theme code cleanup.
* **Theme Version Control Friendly:** Works seamlessly with Shopify GitHub integration, custom developer themes, and headless storefronts.


---

# 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 dynamically by asking a question.

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

```
GET https://docs.turboload.ai/getting-started/theme-extension-setup.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.