Share pages & badges
A share page is a read-only, public page with your project's numbers: for open startups, investors, a client or your users. You choose what's on it, and nothing you leave off is sent to it.
Create the page
Open Project settings → Share and pick:
- The link:
/share/your-name. - What's on it: headline numbers and chart, sources, pages, countries, devices, UTM tags, goals, AI agents (AI crawler visits, people sent by AI assistants, the AI share of traffic) and the live count. Pages and UTM tags are off at first: they can name URLs and campaigns you haven't announced.
- What viewers can do: change the range (today to 90 days) and click a row to filter, only by what the page shows.
- How it looks: title, description, an accent colour, and the website's favicon and link.
- Who can open it: anyone with the link, or only people with a password. Search engines are kept away unless you allow them; other sites can show it in an iframe only if you allow embedding.
Turning the page off takes it and its badges down without losing the settings. Changing the password signs everyone out.
Badges
Badges are small cards with one number, a chart and the logo, for a README, a website footer or docs. Clicking one opens the share page.
<a href="https://agentstats.io/share/acme"><img src="https://agentstats.io/share/acme/badge.svg?metric=visitors" alt="Acme visitors" width="240"></a>
[](https://agentstats.io/share/acme)
| Parameter | |
|---|---|
metric | visitors, pageviews, visits, ai_share (AI share of traffic, with the split), crawlers (AI crawler visits, with the top crawlers), referred (people sent by AI assistants) or live (people here now). |
range | today, 24h, 7d, 30d or 90d; the page's default when left out. |
chart | 0 leaves the chart out. |
theme | light, dark, or left out to follow the viewer's setting. |
label | Your own label, up to 30 characters. |
A badge only shows what the page shows: visitor numbers need the headline section, AI numbers the AI agents section, the live count the live section. A password-protected page's badges say the stats are private. Badges are cached for five minutes.
The Share tab builds the snippet for you, with a preview.