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

# Live Visitor Count Widget

> Show a live count of who's on your site right now on any page. Build the widget snippet in your site settings, style it, and drop the iframe in.

The live-visitors widget shows a **live count of who's on your site right now** on any page you like — a landing page, a status page, an internal screen. You build a small `<iframe>` snippet in your site's embed settings, style it to match, and paste it in. It's self-contained, so there's nothing to install.

## Build the widget snippet

Open your site's settings and find the **Widget** embed tab. Choose a look and options, watch the live preview, and copy the generated `<iframe>` snippet:

* **Variant** — a **card** (a small panel with the count and a mini chart) or an **inline** count that sits in a line of text.
* **Time window** — count visitors over the last 30 minutes, 24 hours, or 7 days.
* **Theme and accent** — match your page's colors.
* **Width** and a small **countries** breakdown you can show or hide.

## Does the widget work on a private site?

* A **public** site's widget works on any page with no key.
* A **private** site's widget carries the site's **private link key** in the snippet, so the count stays gated to people who have it — the widget shows only a live number, never the full dashboard.

The widget reads a single live count and refreshes on its own, so it's safe to embed on a high-traffic page.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Does the live-visitors widget expose my full dashboard?">
    No. The widget shows only a live visitor number, never the full dashboard. On a **private** site the snippet carries the site's **private link key**, so the count stays gated to people who have it. On a **public** site the widget works on any page with no key.
  </Accordion>

  <Accordion title="Will the live-visitors widget slow down my page?">
    No. The widget reads a single live count and refreshes on its own, so it's safe to embed on a high-traffic page. It's a self-contained `<iframe>` snippet with nothing to install.
  </Accordion>

  <Accordion title="What time window does the live-visitors widget count?">
    You choose: the last **30 minutes**, **24 hours**, or **7 days**. Set the window in your site's **Widget** embed tab, along with the variant (card or inline), theme and accent, width, and whether to show a small countries breakdown.
  </Accordion>
</AccordionGroup>

## Related

<Columns cols={2}>
  <Card title="Realtime" icon="signal-stream" href="/docs/realtime-analytics">
    See who's on your site right now in the dashboard.
  </Card>

  <Card title="Embed a dashboard" icon="window-maximize" href="/docs/embed-analytics-dashboard">
    Embed the full read-only dashboard instead.
  </Card>

  <Card title="Public dashboards" icon="share-nodes" href="/docs/public-analytics-dashboards">
    Share the whole dashboard by link.
  </Card>

  <Card title="Install the tracker" icon="download" href="/docs/install-tinyanalytics-tracking-script">
    Start collecting the data the widget shows.
  </Card>
</Columns>


## Related topics

- [Realtime Analytics](/docs/realtime-analytics.md)
- [Embed an Analytics Dashboard](/docs/embed-analytics-dashboard.md)
- [Public Analytics Dashboards](/docs/public-analytics-dashboards.md)