> 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/merchant.md).

# Welcome to TurboLoad

> **Don’t just monitor speed—fix it safely in a draft sandbox.**\
> Automated theme optimization, zero-impact telemetry, and slow-app attribution built for Shopify.

Welcome to the official merchant documentation for **TurboLoad** (`TurboLoad: Core Web Vitals & AI Theme Fixer`).

TurboLoad is a comprehensive Shopify performance platform engineered to help high-growth merchants maximize conversion rates, search engine rankings (SEO), and shopper experience through faster load times.

![TurboLoad Performance Dashboard](https://3104101331-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4kkyKWXlRlIIrT0xXLUz%2Fuploads%2Fgit-blob-47f31e50d385cc2db8a1593ade2f652548365297%2F01_dashboard.png?alt=media)

***

## Why TurboLoad is Different: The Three Pillars

Unlike traditional speed monitoring tools that merely give you a list of complex errors or third-party apps that inject heavy scripts, TurboLoad operates on three fundamental principles:

1. **Zero-Impact Storefront Telemetry:**\
   TurboLoad pairs Shopify's native real-user monitoring (ShopifyQL RUM) with an ultra-lightweight (under 5KB) passive theme extension. We never slow down your store to measure it.
2. **Safe Sandbox Theme Remediation:**\
   Never risk breaking your live store. TurboLoad automatically duplicates your published theme into an isolated draft sandbox, executes automated Abstract Syntax Tree (AST) optimizations, generates an interactive diff and preview link, and lets you review before publishing with a single click.
3. **Actionable Slow-App Attribution & AI Guidance:**\
   Quickly see exactly which third-party tracking scripts, widgets, and chat apps are blocking the browser main thread and dragging down your Interaction to Next Paint (INP) or Largest Contentful Paint (LCP). Use our built-in AI Performance Advisor to get step-by-step resolution plans.

***

## Navigation Guide

| Section                                                                                 | What You Will Learn                                                                   |
| --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| [**Architecture & Overview**](/getting-started/overview.md)                             | How TurboLoad collects real shopper data and powers optimizations.                    |
| [**Theme Extension Setup**](/getting-started/theme-extension-setup.md)                  | How to activate the Monitor and Optimizer embeds in your Shopify Theme Editor.        |
| [**Performance Dashboard**](/core-performance-features/performance-dashboard.md)        | How to read your Performance Score ring, Core Web Vitals cards, and trend graphs.     |
| [**Multi-Theme Audits**](/core-performance-features/theme-audit.md)                     | How to audit published and unpublished draft themes before major sales events.        |
| [**Theme Fixer & Safe Sandbox**](/core-performance-features/theme-fixer-sandbox.md)     | How to run automated AST code fixes safely in a duplicated draft theme.               |
| [**Storefront Optimizer**](/core-performance-features/storefront-optimizer.md)          | How to defer third-party scripts, set exclusions, and test with bypass queries.       |
| [**AI Performance Advisor & Chat**](/ai-intelligence-suite/performance-advisor-chat.md) | How to diagnose performance bottlenecks and export conversation reports.              |
| [**Predictive App Impact**](/ai-intelligence-suite/predictive-app-impact.md)            | How to simulate performance impact before installing new Shopify App Store apps.      |
| [**Reports & Analytics**](/analytics-and-reporting/reports-and-exports.md)              | How to generate historical comparisons and download standardized CSV and PDF reports. |
| [**Settings & Alerts**](/management-and-configuration/settings-and-alerts.md)           | How to configure score drop alerts, Slack/email notifications, and backups.           |
| [**Plans & Billing**](/management-and-configuration/plans-and-billing.md)               | Plan comparisons (Free, Pro, Business) and subscription management.                   |
| [**FAQ & Troubleshooting**](/reference/faq-and-troubleshooting.md)                      | Answers to common merchant questions and resolution guides.                           |

***

{% hint style="info" %}
**Need Help?**\
Our team is available to assist you. If you have questions about your score, theme remediation, or script deferral, reach out directly through the Shopify Admin app support link or chat with the built-in AI Advisor.
{% endhint %}


---

# 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/merchant.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.