We have extended our Early Bird Tickets for Inspire 2023! Discounted pricing goes until February 24th. Save your spot!

Alteryx Server Knowledge Base

Definitive answers from Server experts.

How to Identify and Fix Users with Duplicate Email Addresses


How to Fix Users with Duplicate Email Addresses

Alteryx Server enforces that users must have unique email addresses. In rare circumstances, if duplicate email values are created, Alteryx Server will fail to upgrade to version 2021.2+. This article provides steps on how to identify the duplicates and correct these values prior to upgrade.


  • Alteryx Server
    • All versions, but these checks are specifically impactful for checking prior to upgrading to 2021.2+
    • Windows Authentication
  • Robo 3T (optional)

Identifying Duplicate Email Addresses


Option A - Identify via Alteryx Application

Read the instructions on this article to run an Alteryx Application that will check users' email address and other values in your Server's MongoDB database.
This application will also attempt to identify which of the users is the duplicate user, in the event that your Gallery Administrator is not able to determine which user is the duplicate.
Once you have identified the users with duplicate emails, see the "Fix Duplicate Email Addresses" section below.

Options B - Identify via Mongo Query (Advanced)

  1. Connect to the AlteryxGallery database using Robo 3T (instructions found here )
  2. Run the following query:
db.getCollection("users").aggregate([{ "$group" : { "_id" : "$Email","count" : {"$sum" : 1.0}}},{ "$match" : { "count" : { "$gt" : 1.0}}}],{"allowDiskUse" : false})

Fix Duplicate Email Addresses

Once you have identified the users that have duplicate email addresses (if any) your Gallery Administrator must complete the following steps:
  1. Log into the Gallery > Admin section.
  2. Navigate to the Users page, and locate the user with the duplicate email address.
  3. On that user's profile, update the email address to a unique email.
  4. Click Save.

If you have already attempted the upgrade and it did not complete successfully due to these duplicate users, please contact Alteryx Support.

    Additional Resources