> ## Documentation Index
> Fetch the complete documentation index at: https://topten.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Theme setup

> Enable the tracker app embed and add the Live View Counter to your product template so data starts flowing.

> [!WARNING]
>
> Until theme setup is complete, no data is collected and every dashboard stays empty. This is the most common cause of "the app shows nothing".

Tutorial: Theme setup

1:08

Enable the tracker app embed, add the Live View Counter block to your product template, and confirm everything in the app.

Captions available via the player's CC control.
[Download the video](https://topten.mintlify.site/assets/videos/theme-setup.mp4)
if the player does not load.

## Enable tracking in your theme

**1. Enable the tracker app embed**

In Shopify admin, go to **Online Store → Themes → Customize**. Open the **App embeds** tab and switch on **Product Insights Tracker**, then save the theme.

![The theme editor's App embeds panel with the Product Insights Tracker toggle switched on](https://mintcdn.com/topten/2YsBSa5qZEqiYl41/assets/screenshots/theme-app-embeds.png?fit=max\&auto=format\&n=2YsBSa5qZEqiYl41\&q=85\&s=a91dec9e2f9ba0aeae417ca44052b928)

The tracker is what records views, cart activity, and live presence. Without it, nothing else works.

**2. Add the Live View Counter block**

Still in the theme editor, open your **product template** and add the **Live View Counter** block where you want the count to appear — under the price or next to the buy buttons works well.

The block has its own settings:

* **Label** — the text shown after the count. Default: "people are viewing this right now".
* **Dot color, text color, background color** — match the pill to your theme.

Save the theme when you're done.

What the block looks like in place — the counter pill under the product title:

![A product page with the Live View Counter pill under the product title, showing one active viewer](https://mintcdn.com/topten/2YsBSa5qZEqiYl41/assets/screenshots/storefront-counter-closeup.png?fit=max\&auto=format\&n=2YsBSa5qZEqiYl41\&q=85\&s=11aa9050de7e9192aea6cb8d64fc2c4d)

**3. Confirm in the app**

Open Live Product Insights and go to **Settings → Theme setup**. The card repeats these steps and includes a button that opens your theme editor directly.

## Visitor consent

The tracker respects Shopify's Customer Privacy API. It sends data only from visitors who have consented to analytics processing. On storefronts without a consent API, collection proceeds normally.

> [!WARNING]
>
> If your store never shows a cookie banner, visitors can never grant consent — and no data will ever be collected. To fix this: **Settings → Customer privacy → Cookie banner**, turn **off** "Use automated settings", set the region to **All regions**, and save. See [Troubleshooting](https://topten.mintlify.site/troubleshooting.md).

## Why the counter stays hidden

The Live View Counter shows a real count or nothing at all — it never displays "0 people viewing". When a product has no active viewers, the counter is removed from the page entirely, and it reappears within seconds of someone opening that product.

> [!NOTE]
>
> An active viewer is a shopper with a product page currently open. Their browser sends a heartbeat every few seconds, and they stop counting shortly after leaving or closing the tab. The default presence window is 60 seconds and is adjustable in [Settings](https://topten.mintlify.site/settings.md).

Once tracking is enabled, see [First data](https://topten.mintlify.site/getting-started/first-data.md) for when each kind of data appears. If the counter or dashboards still show nothing, work through [Troubleshooting](https://topten.mintlify.site/troubleshooting.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.