Custom events and properties

Send an event from JavaScript:

plausible('Signup')

Attach properties and a callback:

plausible('Signup', {
  props: { plan: 'pro' },
  callback: () => { location.href = '/welcome' },
})

The callback receives { status }  when the request finishes.

Before the script has loaded

The defer  script defines window.plausible  when it runs. To queue events before that, add this stub:

<script>window.plausible = window.plausible || function () { (window.plausible.q = window.plausible.q || []).push(arguments) }</script>

Limits

What Limit
Event name 120 characters
Properties per event 30
Property name 120 characters
Property value 500 characters
Page path 500 characters

Property values are stored as text. Booleans become true  and false .

See the results

  1. Create a goal for the event name.
  2. Open Behaviors → Goals for conversions.
  3. Open Behaviors → Properties to break an event down by its properties.

Don't put personal data in event names or properties. Tidemark stores exactly what you send.