> For the complete documentation index, see [llms.txt](https://shopvid.gitbook.io/shopvid-shoppable-video-reels/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://shopvid.gitbook.io/shopvid-shoppable-video-reels/widgets-load-speed/speed-check.md).

# Speed Check

Speed check lets you test how fast the Shopvid widget loads on your actual storefront, measured from a real browser session, not a simulation. Use it to spot performance issues before your customers do.

### Prerequisites <a href="#prerequisites" id="prerequisites"></a>

* The Shopvid widget is installed on at least one page in your theme
* App embed is enabled in your Shopify theme settings

### Steps <a href="#steps" id="steps"></a>

#### Step 1: Open the Dashboard <a href="#step-1-open-the-dashboard" id="step-1-open-the-dashboard"></a>

In the Shopvid sidebar, click **Dashboard**. Scroll to find the **Speed check** card.

#### Step 2: Select a page to test <a href="#step-2-select-a-page-to-test" id="step-2-select-a-page-to-test"></a>

In the **Page to test** dropdown, choose which page type to run the test on: **Homepage**, **Product page**. Pick the page where your widget is installed.

#### Step 3: Run the test <a href="#step-3-run-the-test" id="step-3-run-the-test"></a>

Click **Start widget performance test**. Shopvid opens your live store in a new tab, measures how the widget loads, then returns the results to the Dashboard. Keep the tab open until the test finishes.

#### Step 4: Read the results <a href="#step-4-read-the-results" id="step-4-read-the-results"></a>

Three metrics appear with a status badge each:

<table><thead><tr><th>Metric</th><th width="197.44921875">What it measures</th><th width="143.89453125">Fast</th><th width="140.6875">Average</th><th>Slow</th></tr></thead><tbody><tr><td><strong>Widget load time</strong></td><td>Total time for the widget to fully load</td><td>Under 1s</td><td>1–3s</td><td>Over 3s</td></tr><tr><td><strong>First render</strong></td><td>When shoppers first see the widget</td><td>Under 500ms</td><td>500ms–1s</td><td>Over 1s</td></tr><tr><td><strong>Widget size</strong></td><td>Total size of scripts and assets</td><td>Under 512 KB</td><td>512 KB–2 MB</td><td>Over 2 MB</td></tr></tbody></table>

<figure><img src="/files/Md6KtxtPSIvXhqmEq1Qy" alt=""><figcaption></figcaption></figure>

#### Step 5: View test details (optional) <a href="#step-5-view-test-details-optional" id="step-5-view-test-details-optional"></a>

Click **View details** to see the browser environment captured during the test — connection type, browser, viewport, and exact timestamp. Useful if you need to report a performance issue to support.

#### Step 6: Run the test again <a href="#step-6-run-the-test-again" id="step-6-run-the-test-again"></a>

Click **Run again** to retest at any time — for example after making theme changes or optimizing your setup.

{% embed url="<https://app.arcade.software/share/oFlaYn0ASm6fQJBy3eXl>" %}

### Tips <a href="#tips" id="tips"></a>

* Run the test on the page where most of your traffic lands for the most relevant result
* If the test times out, make sure the diagnostic tab finished loading and try again
* If you see **Widget not detected**, confirm the Shopvid widget block is added to the page you selected
* A **Heavy** widget size result — click **Contact us** with the message "I want to optimize page loading" to get help from support

<br>


---

# 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://shopvid.gitbook.io/shopvid-shoppable-video-reels/widgets-load-speed/speed-check.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.