Duplicate users

Learn how to find and merge duplicate users, so you can maximize the effectiveness of your campaigns and Canvases.

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.

Bulk merging

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.

• example csv file

Step 3: Merge your duplicates

If you’re satisfied with the results of your preview, select Merge all duplicates.