Privacy-friendly analytics docs

Install one lightweight script, understand your traffic without cookies, and keep your visitors' privacy intact.

your-site.html
layout.blade.php
<script
src="https://cdn.usage.io/latest.js"
defer
></script>

Get started

Documentation

Welcome to the usage.io documentation. Here you will find step-by-step guidance for adding analytics to your site, reading your dashboard, managing billing, and understanding how we handle visitor data.

usage.io is privacy-focused website analytics: a single lightweight script, no cookies, and an app dashboard for traffic trends, top pages, devices, browsers, geography, and how long visitors stay on your site.

Add your website

Register your domain and get your tracking snippet.

Install the tracker

Where to place the script and how it behaves.

Dashboard overview

Charts, date ranges, breakdowns, and Live views.

Privacy and data

What we collect and how pseudonymization works.


If you are setting up usage.io for the first time, work through these steps in order:

  1. Create an account at usage.io. Registration starts a 7-day Starter trial (see Plans and trials). You may be asked to add a payment method during onboarding; you are not charged until the trial ends if you added a card.
  2. Add your website with the hostname you want to measure (Add your website).
  3. Install the tracking script on every layout or template that should send page views (Install the tracker).
  4. Confirm data is flowing using the in-app waiting state or the checks in Verify tracking.
  5. Set your timezone under Account settings so charts use the date boundaries you expect.
  6. Exclude internal traffic if needed (Exclude traffic).

What you can do in the app

AreaWhat you will find
DashboardTeams, site list, and per-site analytics
Site analyticsSummary metrics, chart, top paths, browsers, devices, countries, map
LiveGeographic map for recent traffic on that site
Site settingsSnippet, path/IP filters, Do Not Track option, reset or delete data
BillingPlan, page-view tier, usage, invoices, payment method, cancel or resume
User settingsName, timezone, theme, email, password, two-factor authentication

Documentation sections

  • Get started — add a site, install the script, verify tracking
  • Using usage.io — dashboard, settings, exclusions, account, teams
  • Billing — plans, trial, usage limits
  • Privacy — data practices and FAQ
  • Developers — Tracker reference for ingest behavior and CSP

Product questions: Contact.

Policies: Privacy, Terms, Disclaimer.

Pricing and plan comparison: usage.io/pricing.