Introduction to events edit

The event feature is highly experimental, expect issues and please report them! To access this feature in your dashboard go to[YOUR WEBSITE]. In the previous version we used cookies, this is now removed. We want to stay a cookie-less solution to be GDPR, CCPA, and PECR complient out-of-the-box.

Install embed script

To start working with events you need to have a recent version of our script. This script includes the normal page view functionality and the events feature.

<script async defer src=""></script>

Or if you use our custom domain feature:

<script async defer src="https://[YOUR SUBDOMAIN LINKING TO US]/latest.js"></script>

Developers: place this script in the <head> or top part of your <body> in your html. The second script (latest.js) can be placed elsewhere on the page if you like.

This little snippet creates a simple function called sa. After that it loads the Simple Analytics script asynchronously (it does not have any effect on your page load).


The sa-function is the function you’ll need to use to create events. To track an event it’s as simple as this:


In the background we add the events to the current page view. With the page view is a referrer saved, this referrer is also saved with the event.

Valid event names

We want to keep events very simple. That’s why we only allow alphanumeric characters and underscores (_). We convert events to lower case and invalid names to a version which is valid. This way your events are always saved.

Tracking over multiple pages

We don’t store anything on the computer of your visits so naturally events will not be linked when a visitor navigates between page. Unless it’s a SPA (Single Page App) which does not reload the whole page but only a part of the page. If you don’t have a SPA you can use Pjax to convert your website to a SPA website.

The variable sa is already used

If the sa variable is already in use you can change it with the data-sa-global attribute:

<script async defer data-sa-global="ba" src=""></script>