Hub 2024.1 Help

Merge User Accounts

Hub lets you merge several user accounts into a single user account. When you merge accounts, all roles, group memberships, and access rights are transferred to the single user account.

When a user logs in to Hub for the first time (for example, with an OpenID account or self-registered account), Hub checks if there is an existing account with the same email address. If an existing account is found, Hub automatically merges the new account into the existing account. For more information, see Merge User Accounts Automatically.

Merge Similar User Accounts Manually

When you find two accounts with different credentials for the same user, you can merge them manually.

This process consists of two steps:

To find duplicate accounts:

  1. Open the Users page.

  2. Click the Find duplicates button.

  3. Select one of the following options:

    • Users with the same emails and similar names...

    • Users with the same emails...

    • Users having at least something in common...

    In the first two cases, the main condition to match is the email address. Only accounts that have exactly the same email addresses are shown in search results. The first option finds only accounts with the same email address that also have similar user names.

    The third option finds all accounts that have either similar user names or similar email addresses. The search result might look like this:

    search results for possibly duplicated user accounts

    Search results are displayed in as visual sets of similar user accounts. To merge all similar accounts within the sets automatically, click the Merge All button. Otherwise, you can opt to review the search results and merge each set of similar users individually.

The next step is to merge the duplicate accounts.

To merge similar user accounts:

  1. Select the account parameters that you want to preserve: username, full name and email address.

  2. If you want ban the merged user account, select the Ban check box.

  3. Click the Merge button.

Merge Several User Accounts Manually

In some cases, you might want to merge several accounts though they are not duplicates.

To merge multiple accounts manually:

  1. In the Users list, select the accounts you need to merge together and click the Merge button.

  2. In the displayed dialog, select the account parameters that you want to preserve: username, full name, and email address.

  3. If you want to ban the merged user account, select the Ban checkbox.

    • Additional settings for assigning the account status and providing a reason for the ban are shown. To learn more about banning user accounts, see Ban User Accounts.

  4. Click the Merge button.

Merge User Accounts Automatically

In some cases, Hub merges user accounts automatically. Auto-merge is performed when a user creates an account with OpenID or LDAP credentials. If an account exists in Hub with the same email address associated with an OpenID or LDAP account, the accounts are merged.

Let's illustrate the auto-merge process logic with the example:

  1. In Hub, there is a user with the login j.johnson with john.johnson@company.com as the email address. This account was imported from another bug-tracker.

  2. After the account was imported, LDAP integration was enabled and configured for this Hub instance. The user tries to log in to Hub with his LDAP account john.johnson, which has the same email address.

  3. Upon login, Hub scans the user base and finds the existing account.

  4. The new account (john.johnson in LDAP) is automatically merged with the existing account (j.johnson). Because the accounts are merged automatically, a separate user account (john.johnson) is not created. The credentials used for this account (username and password) in the LDAP directory service are added to the existing account.

As a result, the user can log in using both j.johnson and john.johnson credentials. The original account for j.johnson is shown in the list of available users.

Last modified: 17 June 2024