Documentation menu

Realtime

Who is on your site right now: the live counter, the visitor feed, and how presence works.

What you see

The realtime view answers right now: how many people are on the site this moment, which pages they are reading, where they are from, on what devices, and a rolling feed of pageviews as they happen. It updates over a live stream, no refreshing.

How presence works

  • The tracker sends a small heartbeat every few seconds while a tab is visible. Presence is built from heartbeats, so someone reading quietly still counts as online.
  • A hidden tab stops heartbeating and the visitor ages out of the view within minutes; realtime state lives about five minutes and is never stored historically.
  • A visitor can be present without a feed entry: the feed lists pageviews, and someone who arrived before your window opened has heartbeats but no fresh pageview. The Online count includes them; that is the ordinary case, not a bug.

Sharing it

The live visitor count can ride a public dashboard (its own switch, count only) and the widgets can embed it anywhere. Realtime is also on the read API for your own code, via short-lived stream tokens; see the read API.