Script variants

Optional behavior is chosen by file name. Combine as many as you like:

<script defer data-domain="example.com"
  src="https://stats.example.com/js/script.outbound-links.file-downloads.js"></script>

Site settings → Tracking shows the right file name for the options you select.

Variant Adds
outbound-links Outbound Link: Click events with a url property
file-downloads File Download events with a url property
form-submissions Form: Submission events
tagged-events Click events from class="plausible-event-name=Signup"
hash Pageviews on #hash route changes
manual No automatic pageviews. Call plausible('pageview') yourself
engagement One non-interactive Engagement event per page view with depth (how far the visitor scrolled: 0, 25, 50, 75, 100) and time (how long they were active, in five bands). It never changes bounce rate or visit duration
local Also track localhost

Tagged events#

With tagged-events, add a class to any link or button:

<a href="/signup" class="plausible-event-name=Signup">Sign up</a>

Then create a goal named Signup.

Manual pageviews#

With manual, nothing is sent until you ask:

plausible('pageview')

Use it when you need to control exactly when a pageview counts, for example after a consent step.

Was this article helpful?
Last updated 10 Nov 2026
Powered by Tidemark Billing