Identifying users

The Waitlyst Identify call allows you to identify your users with an ID of your choice. This can help you create a more comprehensive picture of your users, and reduce the number of Monthly Tracked Users you are billed for.

Why would you want to identify users?

By identifying your users, you can segment them into groups based on common characteristics. For example, you might segment users by language preferences, product version, geographical region, or user persona.

With thoughtful user segmentation, product and growth teams can study how user behaviors vary between segments, then design personalized experiences for each segment.


1. Install waitlyst.js

The fastest way to get started with Waitlyst is to use the SDK. You can send as many events as you like, and it takes just a minute to set up.

npm install @indextrus/waitlyst.js --save

Or as a browser based tag:

<script src=""></script>

2. Identify users using waitlyst.js

To begin identifying users, you will need your Publishable Key and must have setup analytics on your Waitlyst account.

const waitlyst = new Waitlyst("PUBLISHABLE_KEY");

/* Track a page view */;

/* Identify a user */

/* Identify users with custom properties */
waitlyst.identify('1234', {
    firstName: 'John',
    lastName: 'Doe',
    email: ',
    pricingPlan: 'premium'
    country: 'US',
    jobTitle: 'Software Engineer',
    priority: 'high'
    customerType: 'enterprise'

3. When to should you identify users?

We encourage calling waitlyst.identify() once a user is identified after logging in or completed a signup.

4. View users

All identified users have profiles that you can view in the Waitlyst dashboard. You can see the user's traits, financials, and all the events that they have triggered.

User profile