User Identification

User Identification links feedback to individual users in your Userback workspace. When a user submits feedback, their name, email, and any custom attributes you pass are stored alongside it — making it easy to filter, segment, and follow up.

Which method should I use?

Use identify() if your users log in or switch accounts — it updates user data dynamically without a page reload. Use user_data if your application is static or you're using the JavaScript snippet installation method — it sets user data once on page load.

`identify()` — recommended

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

Call identify() after your user logs in. It can be called multiple times — each call overwrites the previous data.

`user_data`

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

Set user_data before the widget initialises. A page reload is required to update it.

What data can you pass?

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	Any additional user details as key-value pairs.	`{ 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

Rules

Key names must not contain special characters.
Values must be strings, numbers, or booleans.
Use a consistent id format across your application.

Accessing 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.

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