Embed widget
Display a live visitor count on your own site with an embeddable widget
The embed widget shows a live visitor count from your Rybbit site on any web page. It's a self-contained iframe — no script tag, no JavaScript on your site, no dependencies.
Try it
Configure the widget below to see how it'll look. The preview shows live data from demo.rybbit.com.
Variant
Time window
Appearance
Options
Requirements
The widget needs a public read-only data endpoint, so you must enable Embed Widget on the site. This is a separate setting from Public Analytics — turning it on only exposes the live count, time series, and top countries to the widget endpoint, not your full dashboard.
Enabling the embed widget does not make your dashboard public. Only the data shown in the widget itself (visitor count, per-minute / per-hour / per-day series, top 5 countries) is accessible — no individual sessions, events, pages, or referrers.
Setup
- Open your site in the Rybbit dashboard and click the settings icon.
- Go to the Embed Widget tab.
- Toggle Enable Embed Widget on.
- Pick your options (variant, time window, theme, accent color).
- Copy the generated
<iframe>snippet and paste it anywhere on your site.
Variants
Card
A self-contained dashboard card showing the live count, an optional bar chart of users over time, and an optional list of top countries.
Options:
| Option | Values | Default | Description |
|---|---|---|---|
| Time window | 30 minutes / 24 hours / 7 days | 30 min | Window the count and chart cover |
| Bar chart | on / off | on | Show a bar chart bucketed per minute / hour / day |
| Top countries | on / off | on | List the top 5 countries in the window |
| Width | 240 – 800 px | 360 px | Iframe width; use max-width: 100% for responsive sites |
Inline pill
A compact pill that fits inline with your site's chrome — e.g. in a header or footer. Shows just the pulsing dot, the live count over the last 30 minutes, and the Rybbit wordmark.
Appearance
- Theme —
darkorlight. The widget background is transparent, so rounded-corner edges blend into whatever sits behind the iframe. - Accent color — pick any hex color. Used for the pulsing live-indicator dot and the bar-chart bars. Defaults to Rybbit emerald.
Example
<iframe
src="https://app.rybbit.io/widget/YOUR_SITE_ID?variant=card&theme=dark&minutes=30&chart=true&countries=true"
style="border: 0; width: 360px; height: 390px; max-width: 100%;"
loading="lazy"
title="Live visitors"
></iframe>If you self-host Rybbit, replace app.rybbit.io with your own domain.
URL parameters
You don't usually need to build the URL by hand — the dashboard generates the right snippet for you — but the widget URL accepts:
| Parameter | Values | Description |
|---|---|---|
variant | card, inline | Layout variant |
theme | dark, light | Color scheme |
accent | 6-character hex (no #), e.g. 10b981 | Pulse / bar color |
minutes | 30, 1440, 10080 | Time window in minutes (card variant only) |
chart | true, false | Show the bar chart (card variant only) |
countries | true, false | Show the top countries (card variant only) |
Caching
The widget HTML and the underlying stats endpoint are both cached for 60 seconds on the server, so embedding the widget on a high-traffic page won't put pressure on your Rybbit instance. The visible count refreshes once per minute.