VRCAnalyticsDocsDashboard →

Dashboard tour

What the numbers mean and how to read them.

Your worlds list

The main dashboard shows every world you've registered. Each card shows a status badge, a recent-activity indicator, and a key-reveal button. Badges you'll see:

  • ⏳ Waiting for first beacon — world is registered but hasn't fired a beacon yet. Binds on the first join after upload.
  • ● Active — world is live and receiving beacons
  • ⚠ Deleted on VRChat — our daily check couldn't find this world on VRChat's API. Data preserved; consider archiving.
  • ⚠ Unlisted — world is no longer marked public on VRChat
  • 📦 Archived — you manually archived this world

Overview stats

Five stat cards: Online Now, Total Visits, Unique Visitors, Avg Session, Returning
The stat row at the top of each world's analytics page.

Online Now

Sessions with a join event in the last hour and no subsequent leave. Counts players currently in any instance of your world across all regions.

Total Visits

Raw count of join events in the selected time window. Every individual join ticks this up, even if the same player rejoins multiple times.

Unique Visitors

Count of distinct sessions (one session = one player within one hour of joins from one IP). If the same player visits five times in an hour, that's one unique visitor; across two separate hours, two.

Visits vs visitors

Total Visits and Unique Visitors will match for single-person testing. They diverge when a player rejoins within the same hour (+1 visit, 0 visitors) or visits again in a later hour (+1 both).

Avg Session

Average session duration in seconds, computed from paired join/leave events. Sessions without a matching leave (player crashed, force-closed VRChat) aren't counted.

Returning

Sessions that appeared on 2 or more distinct dates in the window. Populates naturally as users come back to your world on different days.

Charts

  • Daily visitors — unique visitors per day
  • New vs returning — split of first-time vs repeat visitors
  • Platform breakdown — PC VR / desktop / Quest share
  • Peak hours — which hours of the day see the most traffic
  • Day-of-week heatmap — traffic intensity across weekdays × hours
  • Session distribution — how long players typically stay
  • Hardware breakdown — top GPUs, OSes, RAM/VRAM tiers of your audience

Zone table

If you set up a Zone Beacon, each zone shows four columns: Online now (green dot = live count), Total visits, Unique, and average dwell. Overlapping zones count a player in each overlapping zone — expected behavior for nested areas likefirst_floor containing lobby.

Zone table showing four zones, one with green dot for Online now
A zone table with one player currently in one of the rooms.

Suspicious source warning

Red warning banner: X suspicious beacons from Y non-VRChat sources in the last 30 days
The key-leak warning banner.

When beacons arrive with a User-Agent that doesn't look like a VRChat client (curl, scripts, browsers), they're flagged. A small number is noise (occasional bot scans). A sustained count from a few IPs suggests someone is spamming your endpoint — consider rotating your setup key.

Data export

Each world page has a CSV export button that dumps the raw events for your own off-platform analysis. Includes timestamps, event types, session IDs, platforms, and durations.

Next: Zone heatmaps →