# All guides

> The one tag that works everywhere, where to paste it, and how to confirm the first pageview arrived.

Section: Installation guides  
Canonical page: https://statsy.co/docs/install  
Last updated: 2026-09-15

Statsy is one script tag. It is about 3 KB gzipped, loads deferred, and never blocks a paint. Every site gets a public site key that starts with `ws_`; the install screen prints the tag with your own key already filled in.

```html
<script defer data-website-id="ws_XXXXXXXX" data-domain="yourstartup.com" src="https://statsy.co/js/script.js"></script>
```

Paste it inside `<head>` on every page, in the layout or base template rather than a single page. Keep `defer`, do not change the site key, and do not add the tag twice.

## The two attributes that matter

- `data-website-id` is your site key. It is required.
- `data-domain` is the site’s main domain. Links to any other host count as outbound clicks.

Every other attribute is optional and documented in the [script reference](https://statsy.co/docs/tracking-script).

## Confirm it works

1. Deploy, then open your siteLoad any page of the real domain once in a normal browser tab.
2. Watch the install screen or LiveThe install screen turns green as soon as the first pageview arrives. **Live** shows the same visitor on the globe, with their city and the page they are on.
3. Click aroundA second page should appear within a few seconds. Single-page apps count client-side navigation too, so the path in **Live** should follow you. See [Single-page apps and route changes](https://statsy.co/docs/tracking-script/spa).

> **Watch out.** Beacons are only accepted from the site’s domain and its subdomains, plus any additional domains you added in **Site settings › General**. A preview host such as `yoursite.webflow.io` or `yourapp.vercel.app` is dropped until you add it. See [Subdomains and multiple domains](https://statsy.co/docs/tracking-script/subdomains-and-cross-domain).

## Serve it from your own domain

Every guide below also works with a first-party proxy host. Set one in **Site settings › Tracking** and the `src` becomes `https://s.yourstartup.com/js/script.js` instead, which ad blockers leave alone. See [Serve the script from your own domain](https://statsy.co/docs/tracking-script/first-party-domain).

## Pick your platform

- Hand-written pages and templates: [HTML](https://statsy.co/docs/install/html), [Hugo](https://statsy.co/docs/install/hugo), [Docusaurus](https://statsy.co/docs/install/docusaurus).
- JavaScript frameworks: [Next.js](https://statsy.co/docs/install/nextjs), [React](https://statsy.co/docs/install/react), [Vue](https://statsy.co/docs/install/vue), [Nuxt](https://statsy.co/docs/install/nuxt), [SvelteKit](https://statsy.co/docs/install/sveltekit), [Astro](https://statsy.co/docs/install/astro), [Remix](https://statsy.co/docs/install/remix).
- Site builders and CMSs: [WordPress](https://statsy.co/docs/install/wordpress), [Shopify](https://statsy.co/docs/install/shopify), [Webflow](https://statsy.co/docs/install/webflow), [Framer](https://statsy.co/docs/install/framer), [Squarespace](https://statsy.co/docs/install/squarespace), [Wix](https://statsy.co/docs/install/wix), [Ghost](https://statsy.co/docs/install/ghost), [Carrd](https://statsy.co/docs/install/carrd), [Bubble](https://statsy.co/docs/install/bubble), [Google Tag Manager](https://statsy.co/docs/install/gtm).
- Server frameworks: [Laravel](https://statsy.co/docs/install/laravel), [Django](https://statsy.co/docs/install/django), [Rails](https://statsy.co/docs/install/rails).
- AI builders: [Lovable](https://statsy.co/docs/install/lovable), [v0](https://statsy.co/docs/install/v0), [Bolt](https://statsy.co/docs/install/bolt), [Replit](https://statsy.co/docs/install/replit).

> **Tip.** Onboarding has a ready-made prompt for AI coding agents and an email template for asking a developer to install the tag. Both carry your real site key.

Previous: [Set up alerts](https://statsy.co/docs/getting-started/alerts)  
Next: [Install on a static HTML site](https://statsy.co/docs/install/html)