> 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/reference/faq-and-troubleshooting.md).
# FAQ & Troubleshooting
> **Merchant Support Center:** Clear, authoritative answers to common questions about Core Web Vitals, theme extensions, ad tracking safety, and speed diagnostics.
Find quick answers to common questions about scores, Core Web Vitals, theme extensions, and troubleshooting.
***
## Direct Answer: Does TurboLoad slow down my store or break third-party apps?
No. TurboLoad uses lightweight (under 6KB combined) asynchronous theme embeds that load passively without blocking page rendering. Third-party marketing pixels, checkout events, and customer tracking tags continue to fire reliably. If any specific marketing widget or consent banner requires immediate execution, you can whitelist it in the Optimizer Exclusions Table with a single click.
***
## Frequently Asked Questions
### 1. Why is my Performance Score or Core Web Vitals data empty?
* **Theme Extension Inactive:** Check **Themes → Theme Extension** and confirm the TurboLoad Monitor embed is enabled on your **currently published theme**.
* **Traffic Volume:** TurboLoad displays Real User Monitoring (RUM) metrics collected from real shoppers. If your store is new or has very low traffic, it may take a few hours for the first statistical batch to accumulate.
* **Shopify Telemetry Window:** Shopify aggregates real-user performance data on rolling windows. Allow up to 24–36 hours for recent optimizations to be fully reflected across all dashboard graphs.
### 2. Will script deferral affect my ad tracking (Meta Pixel, Google Ads, TikTok)?
No. TurboLoad's Storefront Optimizer prioritizes user experience while ensuring tracking integrity:
* Tracking beacons are deferred by a few hundred milliseconds until the first user interaction or idle frame, but are never blocked or dropped.
* Standard eCommerce events (`PageView`, `AddToCart`, `Purchase`) continue to fire reliably.
* If you have specific pixels that require instantaneous execution, you can whitelist them in the **Optimizer Exclusions Table**.
### 3. How long does it take for Google Search Console to show Core Web Vitals improvements?
Google aggregates real Chrome browser data (CrUX) over a **28-day rolling window**.
* TurboLoad will show your improvements within 24 to 48 hours.
* Google Search Console will progressively shift upward over the subsequent 2 to 4 weeks as older slow sessions roll out of Google's 28-day sample window.
### 4. What happens if I uninstall TurboLoad?
* **Zero residual theme code:** Because TurboLoad uses official Shopify Theme App Extensions, uninstalling the app automatically and completely removes all embed scripts from your storefront.
* **Draft Themes:** Any draft themes created by the Theme Fixer (`[TurboLoad Remediation] ...`) remain safely in your Shopify theme library for your reference unless you choose to delete them.
### 5. Is TurboLoad compliant with privacy laws (GDPR, CCPA)?
Yes. TurboLoad operates on aggregate technical performance metrics (file sizes, execution milliseconds, layout shift scores). We never collect, track, or store personal identifiable information (PII), customer names, email addresses, or checkout credentials.
***
## Troubleshooting Guide
| Issue | Likely Cause | Recommended Resolution |
| ------------------------------------------ | --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **Theme Extension shows "Inactive"** | App embed enabled in a draft theme rather than the published theme. | Open Shopify Admin → Online Store → Themes → Customize (Live Theme) → App Embeds → Toggle ON and Save. |
| **A third-party popup stopped appearing** | Popup script deferred past customer interaction threshold. | Add the popup script's domain (e.g. `privy.com` or `klaviyo.com`) to the **Optimizer Exclusions Table**. |
| **Page looks unstyled for a split second** | Critical CSS being deferred or missing preconnect. | Run the **Theme Fixer** to inject proper `` and critical stylesheet ordering. |
| **Score fluctuates between days** | Variance in shopper device mix (e.g. higher mobile proportion on weekends). | Use the **Reports** page to segment by device (Desktop vs. Mobile) to isolate real performance trends from traffic mix shifts. |
***
## Need Further Assistance?
Our engineering team is always ready to assist you:
* **Shopify App Store Support:** Click the "Get Support" button on our Shopify App Store listing or in your Shopify Admin apps panel.
* **Official Documentation:**
* **Email Support:** `support@turboload.ai`
---
# 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/reference/faq-and-troubleshooting.md?ask=&goal=
```
`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.