UsherStats Docs Contents usherstats.com Start free

Getting started

Five minutes from a new account to your first pageview.

1. Create an account

Sign up at app.usherstats.com/signup with your email address and a password, and confirm the email we send you. Every feature is on every plan, including Free; you can add a card later.

2. Add your site

In the dashboard, choose Add site and give:

  • a name (for you; it is not shown anywhere public);
  • every hostname the site is served on, such as example.com and www.example.com. UsherStats only accepts reports from pages on these hostnames, so a missing one means missing visits;
  • your time zone, which decides where a day begins in your charts.

The site's Install page then shows its public key, which starts with pk_.

3. Add the snippet

Paste this into the <head> of every page, with your own key:

<script defer src="https://collect.usherstats.com/t.js" data-site="pk_…"></script>

That is the whole installation for human analytics. To serve it from your own domain, to see crawlers and AI bots, or to turn on bot protection, see Installing.

4. Visit your site

Open one of your pages in an ordinary browser window, then switch to another tab or close it: the page reports when it is hidden, so time on page and scroll depth are complete. The site's Install page shows when the first report arrives, and the visit appears in the People view within a minute or two.

If nothing arrives:

  • Your browser may send Global Privacy Control (Brave and DuckDuckGo do by default, and some extensions add it). UsherStats does not record those browsers at all. Try another.
  • If you have marked your browser as internal, your visit is under Internal, not People. That is working as intended.
  • If you browse through a VPN that runs on a cloud provider, your visit is counted as a hosting-network visit, under Crawlers.

Troubleshooting covers the rest.

Next

View this page as Markdown