# Share links (/share-links)



A share link is a page anybody can open without an account: your numbers, none of your controls. Use
one for a client, an investor, a teammate who does not need a seat, or a public "open metrics" page.

Open the site, then **Settings**, then the **Share** card. Only an owner of the organization can turn
sharing on or off.

## What a link is [#what-a-link-is]

Creating one gives you an address like this.

```text
https://usepeeko.com/s/7k2mq4vabc3xyz9hn5rt8wd6fj2plq4s
```

The token is 32 characters of randomness, and it is the whole credential: there is no password and no
sign in. Anybody holding the address can read the page, so treat it as a secret and rotate it when it
stops being one.

You can have up to ten links on one site, each with its own name, its own options and its own token.
The name is for you. It never appears on the public page.

## Choose what it publishes [#choose-what-it-publishes]

Every link shows the headline tiles and the chart. Four more cards are yours to turn on or off:
**Pages**, **Sources**, **Where people are** and **Devices**. Turn all four off for a link that shows
only the tiles and the chart.

Two switches sit beside them.

* **The online count.** Shows how many people are on the site right now. It publishes the number and
  nothing else: never who they are, never where they are, never what they are reading.
* **Revenue.** Off by default. It turns on the Revenue tile and the revenue breakdowns, and never the
  individual orders.

## What a reader can and cannot do [#what-a-reader-can-and-cannot-do]

A reader can change the range between **7 days**, **30 days** and **90 days**, and read whichever
cards you enabled. That is the whole surface.

They cannot sign in, filter anything, or open a single visitor. Recent visits, individual clicks,
goals, funnels and the AI crawler tab are absent from a shared page in every case, whatever the link
was configured with. The page never carries the site's id or its tracking key either, so there is
nothing on it to reuse elsewhere.

The page says what it is. A **Public, read only** badge sits in the header, and the footer states that
you chose to publish it, that it is aggregate numbers only, and that you can switch it off at any
time. It is served with `noindex`, so search engines leave it alone, and it is rate limited, so the
address cannot be used to hammer your dashboard.

One more rule is worth knowing: a link only answers while the organization's plan is active. If a
subscription lapses, the page returns the same 404 an unknown link gets, and it comes back on its own
when the plan does. The token is not thrown away, because a lapse is not a decision to stop sharing.

## Replacing and deleting [#replacing-and-deleting]

Both live on the link's own row, and both take effect immediately.

* **Replace link** gives the link a new token and keeps its name and options. The old address stops
  working at once, and so does a badge embedded with it.
* **Delete link** removes it. Anybody still holding the address gets a page that does not exist.

There is no grace period on either, by design. Sharing that cannot be taken back instantly is not
sharing you control.

## The badge [#the-badge]

Each link can also render a small live badge for your own site, linking back to the shared page.

```html
<a href="https://usepeeko.com/s/YOUR_TOKEN"><img src="https://usepeeko.com/s/YOUR_TOKEN/badge" alt="742 people this week, measured by Peeko"></a>
```

The badge is an SVG that reads `742 people this week · Peeko`, counted over the last seven days and
cached for a few minutes. The settings card prints the snippet with your token already in it, so copy
it from there rather than typing it.

Two things to know. The badge never shows your site's name, only the number. And the alt text carries
the number as it was on the day you copied the snippet, while the image behind it keeps updating, so
edit the alt text to something timeless if that matters to you.

Deleting or replacing the link stops the badge with it.
