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

# Installation

> Install Live Product Insights on your Shopify store and understand the permissions it requests.

Live Product Insights shows you what shoppers are doing on your store right now — live product views, cart additions, and honest activity metrics with their time windows. Installation takes about five minutes and does not require any code changes beyond two theme edits covered in [Theme setup](https://topten.mintlify.site/getting-started/theme-setup.md).

Tutorial: Install Live Product Insights

1:08

The complete installation walkthrough — installing the app, reviewing permissions, and what to expect on first open.

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

## Before you begin

* A Shopify store with admin access.
* Permission to install apps (store owner, or a staff account with app permissions).
* Access to your theme editor — storefront tracking needs two theme changes, covered in [Theme setup](https://topten.mintlify.site/getting-started/theme-setup.md).

## Install the app

1. Find **Live Product Insights** on the Shopify App Store (or open the install link provided to you).
2. Click **Install** and review the permissions listed below.
3. When the app opens, you land on the dashboard. It will be empty at this point — that is expected. Storefront tracking only starts after you complete [Theme setup](https://topten.mintlify.site/getting-started/theme-setup.md).

## Permissions requested

| Permission | What it allows | Why the app needs it |
| - | - | - |
| Read products | See your product catalog | Fills the Products pages with titles, variants, and prices |
| Read inventory | See stock levels | Powers inventory-aware insights, restock suggestions, and the stock columns on the Products pages |
| Read orders | Read order data | Produces order, revenue, and conversion metrics |
| Register an app proxy | Create a secure storefront endpoint | Connects the storefront tracker to the app without exposing it publicly |

> [!NOTE]
>
> On development stores, checkouts create *test orders*. Test orders are excluded from every order, revenue, and conversion metric by default. If you are evaluating the app on a dev store and want those checkouts counted, enable **Include test orders** in Settings.

## After installation

1. Complete [Theme setup](https://topten.mintlify.site/getting-started/theme-setup.md) — the tracker app embed and the Live View Counter block.
2. Open **Settings** and confirm your store's timezone and currency so day boundaries and money values are correct.
3. Browse a product page on your storefront and watch the [Dashboard](https://topten.mintlify.site/guides/dashboard.md) fill in — data appears within a minute ([First data](https://topten.mintlify.site/getting-started/first-data.md)).

## Expected result

* **Live Product Insights** appears in your admin's app list and opens on its dashboard.
* The dashboard is empty until tracking is switched on — that is expected, not a fault.
* No storefront changes are visible yet; the counter and tracker arrive with [Theme setup](https://topten.mintlify.site/getting-started/theme-setup.md).

## Troubleshooting

* **The install button is disabled or you cannot install** — your staff account lacks app permissions; ask the store owner or install with an owner account.
* **The dashboard opens but you expected live numbers** — tracking is off until Theme setup is complete; see [Theme setup](https://topten.mintlify.site/getting-started/theme-setup.md).
* **Test checkouts are not counted** — on development stores, enable **Include test orders** in [Settings](https://topten.mintlify.site/settings.md).
* Anything else: see the full [Troubleshooting](https://topten.mintlify.site/troubleshooting.md) page.

## Related pages

* [Theme setup](https://topten.mintlify.site/getting-started/theme-setup.md) — switch on storefront tracking (required).
* [First data](https://topten.mintlify.site/getting-started/first-data.md) — what appears, and when.
* [Settings reference](https://topten.mintlify.site/settings.md) — confirm timezone, currency, and tracking options.


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