# Merge duplicate contacts

Turn two or three records of the same client into one, keeping the record you choose and moving to it every document linked to the others, and retire a contact without deleting it.

The same client typed twice, by two colleagues or from two apps, splits his cases, invoices and messages between two records. Merging keeps one of them, the **Destination Contact**, points every document of the others to it, and deletes the others.

## Before you start {#before-you-start}

- You need the **Contact** access right at **Creation**.
- One merge takes two or three contacts. A person cannot be merged with the company he belongs to, and two contacts that each have their own user cannot be merged.
- Without the **Administrator** role, the contacts must share the same e-mail address.
- Merging cannot be undone from the window: check the **Destination Contact** before you confirm.

## Select the duplicates {#select}

1. Open **Contacts/Contacts**, type the name in the search bar and press Enter.
2. Tick the lines to merge, or the box in the header of the list to tick them all. The bar above the list shows how many are selected.

![The two records of the same clinic, both ticked; Actions now offers Merge.](https://jaah.app/web/image/12680-949c2625/contacts-merge-duplicates_selected-en.png)

3. Open **Actions** and choose **Merge**.

## Merge them {#merge}

1. The window lists the selected contacts. **Destination Contact** proposes the record that stays, by default the oldest one.
2. Choose another record there if it should stay instead. The cross at the end of a line takes that contact out of the merge.

![The contacts to merge and the one that stays, the Destination Contact.](https://jaah.app/web/image/12684-8e3fbfbb/contacts-merge-merge_dialog-en.png)

On a phone, the window opens full screen with the same fields and buttons.

3. Click **Merge Contacts**. A last screen says that there are no more contacts to merge for this request: click **Close**.

![One record of the clinic is left in the address book.](https://jaah.app/web/image/12686-d547f7b4/contacts-merge-merged_list-en.png)

One record is left. Every document that pointed to a merged contact, from a case to an invoice or a message, now points to it. A field that was empty on the destination takes the value of another contact; a field it already had keeps its own value. The other contacts are deleted; [Recycle bin](/docs/recycle-bin) explains what is kept of a deleted record.

## Retire a contact instead {#archive}

A contact that is not a duplicate but that you no longer use can be archived: open it, open **Actions** and choose **Archive**. It leaves the lists and the choices of every app, and comes back with the **Archived** filter and **Unarchive**, as [Create, edit and delete a record](/docs/essentials/create-edit-and-delete-a-record) shows. **Delete** removes it from the address book, and the recycle bin takes over.

## FAQ {#faq}

### The merge stops with "Email … is already in use." {#already-in-use}

The destination is about to take the e-mail address, or the phone number for "Phone number … is already in use.", of a contact that still exists until the end of the merge, and the [Contact uniqueness](/docs/general-settings/company-and-appearance-settings#contact-uniqueness) rule refuses it. Nothing is merged. Choose as **Destination Contact** the record that has a phone and an e-mail when another one has them, or clear them on the contacts you merge away first.

### "You cannot merge a contact with one of his parent." {#parent}

One of the selected contacts belongs to another one, such as a person and his company. Take the person out of the merge, or clear his **Belongs to** first.

### More than three duplicates. {#more-than-three}

The window refuses more than three contacts at once. Merge them in several rounds, always into the same destination.

### Where do the cases and invoices of the merged contact go? {#documents}

To the destination. The window says it in its own words: all documents linked to one of these contacts are redirected to the destination contact.

---

- Source: https://jaah.app/docs/contacts/merge-duplicate-contacts
- Updated: 2026-10-27
- Version: Contacts 19.0.3.1.0
- Verified: 2026-10-27
