How to Merge Contacts?

[AutomateAaron]

On the contacts feature page it says that on the detail view there is "Duplicate detection and merge actions". Perhaps I'm blind, but I do not see this functionality. How can I merge 2 contacts for the same person?

[stanleys12]

There is no merge feature in the app right now, so you are not missing a button. The docs line "Duplicate detection and merge actions" does not match what the code does.

What exists instead:

• The "Duplicate" action in the contact detail menu and the right-click menu copies a contact into a new one. It does not combine two contacts. See

  webmail/components/contacts/contacts-app.tsx

  Lines 481 to 493 in 310f910

  	const handleDuplicateContact = useCallback(async (source: ContactCard) => {
  	const { id: _id, uid: _uid, created: _created, updated: _updated, ...rest } = source;
  	void _id; void _uid; void _created; void _updated;
  	const data: Partial<ContactCard> = JSON.parse(JSON.stringify(rest));
  	const created = supportsSync && client
  	? await createContact(client, data)
  	: await addLocalContact({
  	id: `local-${generateUUID()}`,
  	addressBookIds: data.addressBookIds || {},
  	...data,
  	});
  	if (created) toast.success(t("toast.created"));
  	}, [supportsSync, client, createContact, addLocalContact, t]);

  (it strips id/uid and creates a new card from the rest).
• Duplicate detection only happens in the vCard import dialog. It compares email addresses of incoming cards against existing contacts and puts a "duplicate" badge on the row. See

  webmail/lib/vcard.ts

  Lines 1477 to 1502 in 310f910

  	export function detectDuplicates(
  	existing: ContactCard[],
  	incoming: ContactCard[]
  	): Map<number, string> {
  	const dupes = new Map<number, string>();
  	const existingEmails = new Map<string, string>();
  	for (const c of existing) {
  	if (c.emails) {
  	for (const e of Object.values(c.emails)) {
  	existingEmails.set(e.address.toLowerCase(), c.id);
  	}
  	}
  	}
  	incoming.forEach((card, idx) => {
  	if (card.emails) {
  	for (const e of Object.values(card.emails)) {
  	const match = existingEmails.get(e.address.toLowerCase());
  	if (match) {
  	dupes.set(idx, match);
  	return;
  	}
  	}
  	}
  	});

  and

  webmail/components/contacts/contact-import-dialog.tsx

  Lines 207 to 211 in 310f910

  	{isDupe && (
  	<span className="text-xs px-1.5 py-0.5 rounded bg-warning/15 text-warning flex-shrink-0">
  	{t("import.duplicate")}
  	</span>
  	)}

  . It only flags them. It does not merge anything.

I found no merge code anywhere under components/contacts or in the contact store.

To combine two contacts today, do it by hand. Open the contact you want to keep, edit it, add the missing emails, phones and so on from the other one, save, then delete the other contact.

The docs page should probably be corrected, or merge tracked as a feature request.

(I looked this up in the code with help from an AI assistant; the links are to the lines I checked.)