🆔 User Identification

Get to know your users for more insightful feedback. User Identification allows you to pre-fill fields such as name, email, and more, enhancing the user experience. Looking to attach non-user data? See Custom Data.

🔐 Company Plan or higher required - Uses JavaScript SDK, more details here.

Prerequisites

Userback Widget installed

Basic Usage (Two Methods)

Recommended Option `identify(uid: string, attributes: object)`

Allows for real-time updates but requires SDK initialization first.

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

Note: identify() updates existing records, not a complete overwrite.

Alternative Option `user_data: object`

Best for quick implementation. Limited in that it can't be updated without reloading.

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

Types of User Data

Name	Description	Example
uid	A string containing your unique identifier for a user.	`123456`
name	User's full name.	`Jane Doe`
email	User's email address.	`[email protected]`
location	User's geographical location.	`Wanaka, New Zealand`
first seen	Timestamp when the user was first identified.	`2021-07-14 09:08:01`
last seen	Timestamp when the user was last active.	`2021-10-13 12:14:22`
Custom Attributes	A JSON object with key/value pairs providing additional information (optional).	`{ plan: 'Pro', account_id: 456785 }`

Note: Location, first seen, and last seen are automatically generated.

Restrictions

Keys should not contain special characters.
Values must be JSON strings, numbers, or booleans.

Accessing User Data

Feedback Dashboard Sidebar

User data can be viewed on the right-hand panel of the feedback dashboard.
Feedback Sidebar

User Details Page

Get an overview of user feedback and properties.
User Details Page

Support & Further Reading

For more information, consult the JavaScript SDK Documentation.

Encounter issues? Please send a message to our support team.