Search the docs… ⌘ K

Quick Start

Name: Simplest Analytics
Author: Simplest Analytics

Get up and running in under two minutes — no build step required.

Create your account

Sign up for a free account at simplestanalytics.com. No credit card required. Once you're in, add your first site from the dashboard — you'll get a unique Site UUID instantly.

Add the snippet

Paste the one-line script tag into the <head> of every page you want to track. It's 2 KB, defers automatically, and works on any stack.

See your data

Open your dashboard. Pageviews appear in real time — usually within a few seconds of the first visit. No sampling, no delays, no setup wizards.

No cookies required. Our script is cookieless by design, honors Do-Not-Track & Global Privacy Control automatically, and requires no cookie banner under GDPR.

Create free account

Edit this page on GitHub →

Installation

Choose your platform. Replace YOUR-SITE-UUID with the UUID shown in your site settings.

Add the script tag to every page, ideally inside <head>.

<!-- Simplest Analytics -->
<script
  async defer
  src="https://simplestanalytics.forum/sa.js"
  data-site="YOUR-SITE-UUID">
</script>

The script is 2 KB gzipped, loads asynchronously, and will never block your page render.

Install the Simplest Analytics plugin from the WordPress Plugin Directory, or add the snippet manually via your theme's functions.php:

<?php
// Add to your theme's functions.php
function sa_tracking_script() {
    echo '<script async defer
      src="https://simplestanalytics.forum/sa.js"
      data-site="YOUR-SITE-UUID"></script>';
}
add_action('wp_head', 'sa_tracking_script');

The plugin automatically handles WooCommerce event tracking (add-to-cart, purchase) with no extra configuration.

Add the script to your app/layout.tsx (App Router) or pages/_document.tsx (Pages Router):

// app/layout.tsx (App Router)
import Script from 'next/script';

export default function RootLayout({ children }) {
  return (
    <html lang="en">
      <head>
        <Script
          src="https://simplestanalytics.forum/sa.js"
          data-site="YOUR-SITE-UUID"
          strategy="afterInteractive"
        />
      </head>
      <body>{children}</body>
    </html>
  );
}

Client-side route changes (both App Router and Pages Router) are tracked automatically via the History API.

Add to your root component's useEffect, or drop the tag into your public/index.html:

// public/index.html — simplest approach
<script
  async defer
  src="https://simplestanalytics.forum/sa.js"
  data-site="YOUR-SITE-UUID">
</script>

// Or in your root component:
useEffect(() => {
  const script = document.createElement('script');
  script.src = 'https://simplestanalytics.forum/sa.js';
  script.setAttribute('data-site', 'YOUR-SITE-UUID');
  script.async = true;
  script.defer = true;
  document.head.appendChild(script);
}, []);

Add to your index.html, or use the vue-router navigation guard approach for SPA route tracking:

<!-- index.html -->
<script
  async defer
  src="https://simplestanalytics.forum/sa.js"
  data-site="YOUR-SITE-UUID">
</script>

// Vue Router — track after each navigation
router.afterEach((to) => {
  if (typeof window.sa === 'function') {
    window.sa('pageview', to.fullPath);
  }
});

Add to your theme's theme.liquid file inside the <head> tag:


<script
  async defer
  src="https://simplestanalytics.forum/sa.js"
  data-site="YOUR-SITE-UUID">
</script>



<script>
  window.sa('event', 'purchase', {
    value: {{ checkout.total_price | divided_by: 100.0 }},
    metadata: { order_id: '{{ checkout.order_id }}' }
  });
</script>

Edit this page on GitHub →

Event Tracking

Fire custom events from any JavaScript on your site using the global window.sa() function. Events appear in your dashboard within seconds.

Basic event

// sa_event is an alias for window.sa('event', ...)
window.sa('event', 'signup_click');
// or equivalently:
sa_event('signup_click');

Event with a value

Pass a numeric value to track revenue or score. You'll see totals and averages in the Events dashboard.

window.sa('event', 'purchase', { value: 49.00 });

Custom properties (metadata)

Attach up to 10 string/number properties to segment events later. Properties are visible in the event detail view.

window.sa('event', 'purchase', {
  value: 49.00,
  metadata: {
    plan: 'team',
    billing: 'annual',
    coupon: 'LAUNCH20',
  },
});

Automatic events

The script collects these automatically — no code needed:

Outbound link clicks — Any link pointing to a different domain
File downloads — .pdf, .zip, .docx, .xlsx and other file extensions
Email link clicks — mailto: href links
Client-side navigations — pushState / popstate / hash changes

Opt-out / filtering

Add data-sa-ignore to any element to prevent its events from being tracked. You can also block your own visits in the dashboard under Settings → Exclusions.

Edit this page on GitHub →

Goals

Goals let you measure conversions — any pageview or event can become a goal. Create them under Sites → Goals in your dashboard.

Pageview goal

Triggers when a visitor lands on a specific URL or path pattern. Useful for thank-you pages, confirmation screens, or any destination page.

E.g. path equals /thank-you or path starts with /checkout/confirm

Event goal

Triggers when a named custom event fires. Use this to track button clicks, form submissions, or any sa_event() call.

E.g. event name equals purchase

Value threshold goal

A variant of event goal that only converts when the event's numeric value exceeds a threshold. Perfect for revenue targets.

E.g. event purchase where value ≥ 50

Setting up a goal

1. Navigate to your site dashboard and click Goals in the sidebar.
2. Click + New Goal, choose the type, and enter the match criteria.
3. Optionally set a monetary value per conversion for revenue reporting.
4. Save. Goals appear on the dashboard immediately and backfill up to 90 days of historical data.

Edit this page on GitHub →

Funnels

Funnels visualise the step-by-step path visitors take through your site, and show exactly where they drop off.

How to create a funnel

Define your steps

A funnel is made of 2–8 steps. Each step is either a pageview (URL match) or a custom event. Steps are evaluated in order — a visitor must complete step N before they can advance to step N+1.

Name your funnel

Give it a descriptive name like "Signup flow" or "Checkout → Purchase". This appears on your Funnels dashboard.

View the visualisation

Once created, the funnel shows a bar chart of visitors at each step, a % drop-off rate per step, and an overall conversion rate from first to last step.

Filter by segment

Apply any of your existing dashboard filters (country, device, source) to see how different audiences flow through the funnel.

Export data

Team plan users can export funnel step data as CSV from the Funnels screen.

Plan requirement. Goals and Funnels are available on the Starter plan and above. View plans →

Edit this page on GitHub →

API Reference

The REST API is available on Team plan and above. Authenticate using a Bearer token generated under Settings → API Tokens.

Authentication

Authorization: Bearer YOUR_API_TOKEN

Endpoints

Method & Path	Description	Plan
GET /api/v1/sites/{id}/stats	Aggregated stats (visitors, pageviews, bounce rate, top pages, sources)	Team+
GET /api/v1/sites/{id}/events.csv	Raw event export as CSV	Team+
GET /api/v1/sites/{id}/export/raw.csv	Raw pageview export as CSV	Team+
GET /api/v1/sites/{id}/export/aggregated.json	Aggregated JSON export	Team+

Query parameters — `/stats`

Parameter	Type	Default	Description
period	string	30d	7d, 30d, 90d, 6mo, 12mo, or custom
start	date	—	ISO 8601 date, required when period=custom
end	date	—	ISO 8601 date, required when period=custom
timezone	string	UTC	IANA timezone, e.g. Europe/London
metrics	string	all	Comma-separated: visitors,pageviews,bounce_rate,duration

Example requests

# Get stats for the last 30 days
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://simplestanalytics.forum/api/v1/sites/YOUR-SITE-UUID/stats?period=30d"

# Custom date range
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://simplestanalytics.forum/api/v1/sites/YOUR-SITE-UUID/stats?period=custom&start=2025-01-01&end=2025-01-31"

# Export raw events as CSV
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://simplestanalytics.forum/api/v1/sites/YOUR-SITE-UUID/events.csv?period=30d" \
  -o events.csv

Example response

{
  "site_id": "YOUR-SITE-UUID",
  "period": "30d",
  "visitors": 12840,
  "pageviews": 38521,
  "bounce_rate": 42.3,
  "avg_visit_duration": 145,
  "top_pages": [
    { "path": "/", "visitors": 4210, "pageviews": 6305 },
    { "path": "/pricing", "visitors": 1830, "pageviews": 2210 }
  ],
  "top_sources": [
    { "source": "google.com", "visitors": 5400 },
    { "source": "direct", "visitors": 3200 }
  ]
}

Edit this page on GitHub →

Integrations

Simplest Analytics works out of the box with every major platform. Click any integration to see the dedicated guide.

WP WordPress SH Shopify NX Next.js GT Gatsby NU Nuxt GH Ghost WF Webflow SS Squarespace

Don't see your platform? The snippet works anywhere JavaScript runs. Ask us for a guide.

Edit this page on GitHub →

FAQ

Looking for answers to common questions? Check out our dedicated FAQ page covering privacy, billing, technical details, and comparisons.

Browse the FAQ

Edit this page on GitHub →

Quick Start

Create your account

Add the snippet

See your data

Installation

Event Tracking

Basic event

Event with a value

Custom properties (metadata)

Automatic events

Opt-out / filtering

Goals

Setting up a goal

Funnels

How to create a funnel

API Reference

Authentication

Endpoints

Query parameters — /stats

Example requests

Example response

Integrations

FAQ

Query parameters — `/stats`