User Identification

User Identification makes it easy to personalize and streamline feedback collection. By identifying users, you can:

Pre-fill fields like name and email to save users time.
Gain deeper insights into user behavior and feedback trends.
Enable segmentation and prioritization of feedback by user type.

How to identify users

User Identification can be implemented using one of two methods.

1. Real-Time Updates with`identify()` (Recommended)

This method allows you to update user information dynamically.

Example:

Userback.identify(123456, {
    name: 'Jane Doe', // required
    email: '[email protected]', // required
    plan: 'Pro',
    account_id: 456785
});

Important Notes:

identify() updates existing records, without overwriting all data.
Ideal for applications where users log in or switch accounts.

2. Static User Data with`user_data`

This method is suitable for simple use cases but requires a page reload to update.

Example:

Userback.user_data = {
    id: 123456, // required
    info: {
        name: 'Jane Doe', // required
        email: '[email protected]', // required
        plan: 'Pro',
        account_id: 456785
    }
};

Important Notes:

Use this method for static applications where updates aren’t needed dynamically.

What data can you capture?

Field	Description	Example	Required?
`id`	Unique identifier for the user.	`123456`	Required
`name`	Full name of the user.	`Jane Doe`	Required
`email`	Email address of the user.	`[email protected]`	Required
Custom Attributes	JSON object with additional user details.	`{ plan: 'Pro', account_id: 456785 }`	Optional
`location`	Automatically generated location data.	`Wanaka, New Zealand`	System generated
`first seen`	Timestamp of the first interaction.	`2021-07-14 09:08:01`	System generated
`last seen`	Timestamp of the most recent interaction.	`2021-10-13 12:14:22`	System generated

Best practices and restrictions

Keys must not contain special characters.
Values should be JSON-supported types: strings, numbers, or booleans.
Use a consistent id format for seamless integration with other tools.

How to access user data

Once users are identified, their data appears in the right-hand sidebar of the Feedback Dashboard. Open any user's User Details Page for a full overview of their feedback history and properties.

Want to learn more?

Read about Custom Data to enrich feedback with session details.
Check the JavaScript SDK documentation for advanced setup options.

Need help? Visit the Help Center or use the chat bubble on this page to contact our support team.