Help

Embed widgets

Use Livedot embeds to place a live map, traffic chart, or visitor counter directly on your site.

Getting started

Enable sharing for your website in the dashboard.
Copy the embed snippet for the widget you want.
Paste the iframe into your site or documentation.
Adjust the supported query parameters if you want a different background, accent, or scale.

Common query parameters

Param	Type	Required	Description
website	string	Yes	Your website id.
token	string	Yes	The share token generated when sharing is enabled.
bg	string	No	Embed background. Defaults to transparent.
branding	1 \| true	No	Explicitly show branding for non-free plans.

Widget-specific options

Map Widget

Full live map with active visitor sessions.

/embed/map

This widget only uses the common query parameters.

Example embed

<iframe src="https://cloud.livedot.dev/embed/map?website=YOUR_WEBSITE_ID&token=YOUR_SHARE_TOKEN&bg=transparent" width="100%" height="400" frameborder="0" style="border:0;border-radius:12px;"></iframe>

Chart Widget

Compact live visitor count with a recent traffic trend.

/embed/chart

Param	Type	Description
accent	string	Line and status color. Defaults to #96E421.
scale	number	Scales the entire card. Defaults to 0.9.

Example embed

<iframe src="https://cloud.livedot.dev/embed/chart?website=YOUR_WEBSITE_ID&token=YOUR_SHARE_TOKEN&accent=%2396E421&scale=0.9" width="260" height="128" frameborder="0" style="border:0;overflow:hidden;"></iframe>

Live Count Widget

Minimal live dot and current visitor count.

/embed/live

Param	Type	Description
accent	string	Status dot color. Defaults to #96E421.
scale	number	Scales the entire counter. Defaults to 0.85.

Example embed

<iframe src="https://cloud.livedot.dev/embed/live?website=YOUR_WEBSITE_ID&token=YOUR_SHARE_TOKEN&accent=%2396E421&scale=0.85" width="260" height="84" frameborder="0" style="border:0;overflow:hidden;"></iframe>