Duplicate users
Learn how to find and merge duplicate users, so you can maximize the effectiveness of your campaigns and Canvases.
To merge duplicate users using the Braze REST API, see POST: Merge Users.
Individual merging
If a user search returns duplicate profiles, you can merge each profile individually from the user’s profile in the Braze dashboard.
Step 1: Search for a duplicate profile
In Braze, select Audience > User Search.
Enter a unique identifier, such as an email address or phone number, for the duplicate profile, then select Search.
Step 2: Merge duplicates
To begin the merge process, select Merge duplicates.
Choose which user profile to keep and which to merge, then select Merge profiles. Repeat this process until you’ve merged all duplicate profiles.
Duplicate user profiles cannot be recovered after merging.
Bulk merging
Bulk merging duplicate users is currently in early access. Contact your Braze account manager if you’re interested in participating in the early access.
When you bulk merge duplicate users, Braze finds profiles with matching identifiers (such as an email address) and merges all their data into the most recently updated profile with an external_id
. If there are no profiles with an external_id
, the most recently updated profile without an external_id
will be used instead.
Step 1: Go to Manage Audience
In the Braze dashboard, select Audience > Manage Audience.
Step 2: Preview the results (optional)
To preview your results before merging your duplicates, select Generate list of duplicates.
Braze will generate your preview and send it to your email address as a CSV file.
In the following example, Braze uses the user’s external ID to flag duplicate profiles and identify which one to keep. If these profiles are bulk merged, Braze will use the profile with an external ID as the user’s new primary profile. Now if that user logs in using a merged profile, Braze will update their new primary profile instead.
Email Address | External ID | Phone Number | Braze ID | Identifier for rule | Profile to keep | Profile to merge |
---|---|---|---|---|---|---|
[email protected] | A8i3mkd99 | (555) 123-4567 | 65fcaa547f470494d1370 | TRUE | FALSE | |
[email protected] | (555) 987-6543 | 65fcaa547f47d004d1348 | FALSE | TRUE | ||
[email protected] | (555) 321-0987 | 65fcaa547f47d0049135c | FALSE | TRUE |
Step 3: Merge your duplicates
If you’re satisfied with the results of your preview, select Merge all duplicates.
Duplicate user profiles cannot be recovered after merging.