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

# Settings reference

> Every setting in Live Product Insights — location, allowed range, default value, and effect.

Settings live in one place: **Settings** in the app's navigation. Changes take effect when you click **Save**.

Tutorial: Settings reference

1:06

A walkthrough of the setting groups — tracking windows, the counter label, low-stock threshold and lead time, retention, and store profile — plus running a product sync.

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

> [!NOTE]
>
> Storefront tracking and the Live View Counter are always on by product design. There is no switch that silently disables measurement — if data or the counter are missing, the cause is setup or consent, not a setting. See [Troubleshooting](https://topten.mintlify.site/troubleshooting.md).

![Settings page: measurement windows, test orders, counter label, low-stock threshold, and lead time](https://mintcdn.com/topten/2YsBSa5qZEqiYl41/assets/screenshots/app-settings.png?fit=max\&auto=format\&n=2YsBSa5qZEqiYl41\&q=85\&s=6d41bb6db388abcaf9fafcd5e6672704)

## Plan & usage

When billing enforcement is active, the top of the page shows a plan card: your current plan, price, cycle dates, and progress bars for the events and storage your plan allows. Without active enforcement the card stays hidden.

## Storefront tracking

| Setting | Range | Default | Effect |
| - | - | - | - |
| Active window | 10–600 seconds | 60 seconds | How long a shopper counts as an active viewer after their last heartbeat. Shorter windows make the live count more strict. |
| View deduplication | 5–1440 minutes | 30 minutes | A repeat view of the same product within this window counts once per session. |
| Attribution window | 1–30 days | 7 days | How far back an order can be linked to earlier cart activity for attributed conversions. |
| Include test orders | On / off | Off | Include test orders — common on development stores — in order, revenue, and conversion metrics. |

## Live counter

| Setting | Range | Default | Effect |
| - | - | - | - |
| Counter label | Up to 80 characters | "viewing this right now" | Text shown after the count on the storefront pill. |
| Minimum viewers to show | 0–100 | 0 | Additional threshold before the counter appears on a product. The counter always hides at zero active viewers regardless of this value. |

## Inventory & restock

| Setting | Range | Default | Effect |
| - | - | - | - |
| Low stock threshold | 0–10,000 units | 10 | Stock level at or below which low-stock insights and restock findings trigger. |
| Restock lead time | 0–60 days | 14 | Supplier lead time used to grade restock urgency in insights and stock review suggestions. |

## Data & privacy

| Setting | Range | Default | Effect |
| - | - | - | - |
| Retention | 7–365 days | 90 days | How long raw event data is kept before automatic nightly deletion. Daily summaries are kept. |

## Store profile

| Setting | Options | Default | Effect |
| - | - | - | - |
| Timezone | 15 IANA zones, including Asia/Dhaka | Etc/UTC | Used for day boundaries, the "Today" filter, hourly charts, and best-time-to-promote. |
| Currency | USD, EUR, GBP, CAD, AUD, INR, JPY, BRL, MXN | USD | Display currency for revenue and order values. |

## Other actions on the Settings page

![Settings page, lower half: timezone, currency; Sync products; theme setup steps; and clear analytics data](https://mintcdn.com/topten/2YsBSa5qZEqiYl41/assets/screenshots/app-settings-scrolled.png?fit=max\&auto=format\&n=2YsBSa5qZEqiYl41\&q=85\&s=ba2efe147ab28a14f46c7dd86c63a85f)

### Sync products now

Pulls your current catalog — titles, variants, prices, and stock — from Shopify into the app. Run this once after installing; after that, product and inventory changes sync automatically through Shopify webhooks.

### Clear analytics data

In the danger zone, behind a confirmation dialog. This permanently deletes all measured data for this store: product events, visitor sessions, active viewers, cart links, orders, daily summaries, and insights. It keeps your settings and the product catalog cache. This cannot be undone.

## Related pages

* [Theme setup](https://topten.mintlify.site/getting-started/theme-setup.md) — the storefront side these settings control.
* [First data](https://topten.mintlify.site/getting-started/first-data.md) — what to expect after changing tracking settings.
* [Privacy](https://topten.mintlify.site/privacy.md) — what is collected, retained, and never stored.
* [Troubleshooting](https://topten.mintlify.site/troubleshooting.md) — when a setting looks right but data doesn't move.


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