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

# Widgets

> Embed live OpenRevenue analytics on your own website: a realtime visitor counter, a traffic badge, and a last-30-minutes chart.

## Overview

Widgets render a slice of your project's analytics inside an iframe you can embed on your own site: a live visitor counter, a last-24-hours traffic badge, or a last-30-minutes activity chart. They are a good fit for open startups, status pages, and portfolio sites that want to show real traffic.

## Enable widgets

1. Open `Settings → Widgets` for your project.
2. Toggle `Widgets` on.
3. Pick a widget type, customize it, and copy the snippet.

Widget data is only served while the toggle is on. Turning it off takes every embedded widget offline immediately. Only a project owner or admin can change this setting.

## Widget types

* `Realtime` — a pulsing dot with the number of people on your site right now. Updates every 15 seconds.
* `Badge` — a compact card with your domain, an hourly visitor sparkline, and the visitor count for the last 24 hours.
* `Chart` — users in the last 30 minutes as a per-minute bar chart with hover tooltips, plus a top-countries list.

## Embed the snippet

Copy the snippet from `Settings → Widgets` and paste it into your site's HTML:

```html HTML theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
<iframe
  src="https://embed.openrevenue.com/widgets/<project-id>/chart?theme=system"
  style="background: transparent !important; border: none; width: 100%; height: 430px;"
  frameborder="0"
  allowtransparency="true"
  title="OpenRevenue Widget"
  loading="lazy"
></iframe>
```

> [!NOTE]
>
> Embed widgets from `https://embed.openrevenue.com` (the embed host). The tracker and public API use `api.openrevenue.com`; the marketing site stays on `www.openrevenue.com`.

> [!NOTE]
>
> By default the widget includes a small "Powered by OpenRevenue" credit. Hiding it is a paid add-on (\$19/mo per project): enable White-label under `Settings → Widgets` for each site you want unbranded. See active count on `Account → Billing`.

## Customization

Widgets are customized through query parameters on the iframe URL, all generated for you by the settings page:

* `theme` — `system`, `light`, or `dark`.
* `mainTextSize` — base text size in pixels (10 to 32).
* `primaryColor` — hex color for the dot and chart bars.
* `secondaryColor` — hex color for the badge sparkline.

The widget background is transparent, so it inherits whatever background your page gives it. Use `Save styles` on the settings page to keep your customization as the project's defaults. To hide the "Powered by OpenRevenue" credit on the iframe widgets, enable White-label for that project (\$19/mo) in settings.

## Notes

* Widgets are read-only and expose aggregate numbers only, never visitor-level data.
* Widget pages are excluded from search engine indexing.
* Embedding works on any site; the iframe is intentionally allowed to be framed cross-origin.


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