Goals

Visitors allows you to send custom events to track user actions and conversions.

Track method

Sends a custom event.

1visitors.track("signup", {
2  source: "footer",
3})

Data attributes

Track clicks declaratively using HTML data attributes. No JavaScript required.

Add data-visitors-event to any clickable element (buttons, links, etc.):

1<button data-visitors-event="Signup">
2  Get Started
3</button>

Adding properties

Add additional data-visitors-* attributes to include event properties:

1<button
2  data-visitors-event="Signup"
3  data-visitors-plan="Pro"
4  data-visitors-source="hero"
5>
6  Get Started
7</button>

This sends a Signup event with properties { plan: "Pro", source: "hero" }.

Tracking forms

For form submissions, it's best to use visitors.track() in your submit handler after validation succeeds. For example:

1const handleSubmit = async (e) => {
2  e.preventDefault()
3  const result = await submitForm(data)
4  if (!result.success) return
5  visitors.track("signup", {
6    source: "footer",
7  })
8}

This ensures you only track successful submissions and events aren't tracked for failed validation failures.