---
updatedAt: 2026-09-16T07:31:31.000Z
agentTools:
  projectIndex: https://docs.waydev.co/llms.txt
---

# Merge Profiles

How to merge duplicate contributor profiles.

**An important step in setting up your account is merging duplicate contributor profiles. By doing this, your contributors' work is reflected holistically and accurately, even if they use multiple identities.**

**This is a mandatory action.**

You can choose one of two ways to merge contributors’ profiles in Waydev:

* ### [Merge Suggestions](https://docs.waydev.co/docs/merge-contributor-profiles#merge-suggestions-1)
* ### [Auto Merge](https://docs.waydev.co/docs/merge-contributor-profiles#automatic-profile-merging)
* ### [Manual Merge](https://docs.waydev.co/docs/merge-contributor-profiles#manual-profile-merging)

***

### Group-scoped visibility and filtering

On the **Team Management** page, teams and contributors are now scoped by Group.
If you revisit the Setup process after having defined Groups (Projects, Initiatives etc) for your organization, note that:

* **Main users and Owners** continue to see all teams and contributors.
* **Other users** see **only the Groups they have been granted access to** (in the Operational Users page).
* In both **Contributors view** and **Teams view**, you can filter by one or more Groups you have access to, in order to reduce clutter and manage teams and contributors more effectively.
  * <Image align="center" border={true} width="500px" src="https://files.readme.io/faa5e2d38314e96d6c5a99fa28d1c112bcd6b1425873a776a0a6e3d45e47d969-Screenshot_2026-01-15_at_12.40.31.png" className="border" />

***

## Merge Suggestions

You can merge profiles using the **Merge Suggestions** option. This option automatically identifies contributor profiles with similar or identical names or emails.

<Image align="center" border={true} src="https://files.readme.io/badf957cc98623b96e1ead4acfd750f82a85dbe4d435fe05267b9c6af212d946-Merge_suggestion.gif" className="border" />

***

**Step 1:** Navigate to **Teams Management** in the **Setup** section.

**Step 2:** Click on the **Merge Suggestions** button.

<Image align="center" border={true} src="https://files.readme.io/a692f4c095e0d9d6ba97111d7923b7eedabff68cbe3c6696c2977292a887d0f4-Screenshot_2025-07-22_at_15.57.36.png" title="image (32) copy.png" className="border" />

* **Step 3:** After the list of potential matches appears, select the contributor profile you want to merge by clicking on the flag associated with their name.

<Image align="center" border={true} src="https://files.readme.io/ee0da37b85b1716b89dbe0b0e51469dd00b993a880931d133aa8c1f21f8a508f-Screenshot_2025-07-22_at_15.59.01.png" title="image (32) copy 2.png" className="border" />

* **Step 4:** Once you select a contributor, profiles with similar/identical names or email addresses will appear in a table. Select the engineer profiles you want to merge by simply clicking on them (or select all if applicable).

<Image align="center" border={true} src="https://files.readme.io/9992b50ef777f4977ddc7c626db557f952f372327bac10bf27739096628bb46d-Screenshot_2025-07-22_at_16.02.47.png" className="border" />

* **Step 5:** Click **Merge Selected** and choose whether you want to include the merged profile in the metrics.

<Image align="center" border={true} src="https://files.readme.io/0ac1b58a83be62a94c5cf5cbcdebd425d7ef39c11c1995f1c735b23d63875095-Screenshot_2025-07-22_at_16.02.47_copy.png" className="border" />

If all options are incorrect, click **Ignore** to prevent this suggestion from appearing again.

***

## Automatic Profile Merging

You can merge profiles using the **Start Auto Merge Process** option. This option automatically merges contributor profiles that have **identical** emails.

**Step 1:** Navigate to **Teams Management** in the **Setup** section.

**Step 2:** Click on the **Start Auto Merge Process** button.

<Image align="center" border={true} src="https://files.readme.io/58b9203320e825a27f83cce596052191a6d2f33924933061e160cca4ae0ff1ba-Screenshot_2025-07-22_at_16.04.20.png" className="border" />

**Please be aware that this is a background process, and specific settings for the contributors' accounts might not be preserved during merging. Therefore, it is recommended to use Merge Suggestions when initially setting up the account.**

***

## Manual Profile Merging

If you do not want to use the **Merge Suggestions** or **Auto Merge** option, you can merge contributor profiles directly from the **Teams Management** page by selecting the profiles you want to merge.

<Image align="center" border={true} src="https://files.readme.io/6f6b2389a00d50b15a377266fa9d14f988890248a29f22ce2f2107ef285558c6-Manual_Merge.gif" className="border" />

***

* **Step 1:** Select the profiles you want to merge by clicking their corresponding checkboxes.
* **Step 2:** Click the **Merge Selected** button.

<Image align="center" border={true} src="https://files.readme.io/46394bc24f0b4584dc9bc6e83ff2fe6bd35816d1bcae2e15dad5121eb931d206-Screenshot_2025-07-22_at_16.12.54.png" className="border" />

* **Step 3:** The **Merge** modal will appear, displaying the profiles you selected. Click the **Merge Selected** button from the upper right-hand side and select whether you want to include the merged profile in the metrics.

<Image align="center" border={true} src="https://files.readme.io/a4fc3b1c80dbd5cf9f6be1a5f780664672bb846dfd7cc28e1cea4a6b1522962d-Screenshot_2025-07-22_at_16.14.28.png" title="image (32) copy 3.png" className="border" />