Skip to content

Embeddable widgets

Four widgets that turn your traffic into something you can paste into a website, README, or landing page. Tiny, configurable, and read a narrow slice of your stats directly from Statable. No backend setup.

What you get

WidgetWhat it showsBest for
Live UsersVisitors on your site right now, with a 30-minute trend barBuild-in-public proof, "still alive" badge, social proof
Top CountriesRanked list of countries with flags and visitor countsCompact stat block, sidebars, footers
Visitor mapA flat world map shaded by visitor locationMarketing pages, conference talks, dashboards on TVs
3D GlobeA rotating 3D globe with dots or country shadingOSS READMEs, hero sections, "wow" moments

Each widget is a single <script> tag. Paste once, done.

How they work

  1. Open Site settings → Widget, pick a widget type (Globe, Map, Top Countries, Live Users), and configure what it shows: time period (1d / 7d / 30d / 90d), how many countries to display, percentages vs raw numbers, theme, colours.
  2. Statable hands you a public hash like 03D3Cfb9eA and the ready-to-paste <script> tag.
  3. Drop the tag on any HTML page. The widget renders the slice of data you configured.
  4. Numbers refresh automatically. Live Users every few seconds, the others every 5–10 seconds.

The hash is widget-only, separate from your dashboard. Embedding a widget publishes just that narrow slice (e.g. country breakdown for the last 7 days) without exposing the rest of the dashboard. Your full reports stay private to your account.

No build step, no React/Vue setup, no API key. Works in any HTML page, static site to CMS.

You'll need

  • An active Statable site
  • A widget configured in Site settings → Widget
  • The ready-to-paste <script> tag from that page (data-hash is already filled in)

30-second example

The smallest possible Live Users widget:

<script
  defer
  src="https://statable.com/js/luw.js"
  data-hash="YOUR_PUBLIC_HASH">
</script>

Reload the page and the widget appears.

Each widget page shows the full set of options: colours, themes, sizes, periods.

Customisation

Every widget supports the same baseline options, plus a few specific to its visual style:

OptionValuesDefaultNotes
data-themelight / dark / autoautoAuto follows the visitor's OS preference
data-period1d / 7d / 30d / 90d7dTime window the widget summarises
data-width / data-heightauto or pixels (400, 600)responsiveAuto fills the parent container
data-primary-colorHex (#0061FE)Statable blueUsed for highlights and accents

Widget-specific options (rotation speed, ocean colour, display mode) live on each individual page.

Common questions

What exactly does a widget make public? Only the slice you configured for it. If you set up a Top Countries widget for the last 7 days, that table is what the widget exposes — nothing more. Custom events, goals, individual page paths, and the rest of your dashboard stay private to your account. The widget hash is separate from any dashboard sharing setting, so embedding a widget doesn't open up your full stats.

Do I need to enable Public Access for widgets to work? No. Widgets are independent of the Public Access toggle in General. A site can keep its dashboard fully private and still serve widget data. The Hobby plan ships with widgets enabled and the dashboard private by default — that combination works.

Can I hide the "Powered by Statable" link? On paid plans, yes. On the free Hobby plan (.edu, GitHub Pages, and GitLab Pages domains), the small attribution stays visible. That's the trade for unlimited free use.

Does it slow down my page? Each widget bundle is around 5–15 KB gzipped and loads with defer. It runs after your main content renders.

Can I embed multiple widgets on the same page? Yes. Drop as many as you like. They share network requests where possible, so two widgets on the same page aren't twice the cost.

Pick a widget:

Once you've embedded a widget, see Public dashboard & sharing for the related share-link experience.

Ready to take control of your web analytics? Try Statable free for 30 days — no credit card required, full feature access, GDPR-compliant by default. Start your free trial or view a live demo.