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.