Tracking custom events
Last updated September 24, 2025
Custom Events are available on Enterprise and Pro plans
Vercel Web Analytics allows you to track custom events in your application using the function. This is useful for tracking user interactions, such as button clicks, form submissions, or purchases.
Make sure you have version 1.1.0 or later installed.
This will track an event named Signup.
This tracks a "Signup" event that occurred in the "footer" location. The second event tracks a "Purchase" event with product name and a price.
The following limitations apply to custom data:
- The number of custom data properties you can pass is limited based on your plan.
- Nested objects are not supported.
- Allowed values are , , , and .
- You cannot set event name, key, or values to longer than 255 characters each.
Once you have tracked an event, you can view and filter for it in the dashboard. To view your events:
- Go to your dashboard, select your project, and click the Analytics tab.
- From the Web Analytics page, scroll to the Events panel.
- The events panel displays a list of all the event names that you have created in your project. Select the event name to drill down into the event data.
- The event details page displays a list, organized by custom data properties, of all the events that have been tracked.
Was this helpful?