Lead Merge
Lead merge lets you combine duplicate or related leads into a single unified record, preserving a complete history of artifacts β notes, tasks, call logs, and email activity β while eliminating redundancy in your lead pipeline. You can preview the outcome before committing, review merge history, and undo a merge when needed.
Audience: Lead managers and agents who maintain lead data quality in AI Lead Manager.
On this page
- Before you begin
- Preview a merge before committing
- Merge leads
- View merge history
- List child leads of a merged parent
- Preview an unmerge operation
- Unmerge a lead
- Tips
- Troubleshooting
- Related articles
Before you begin
Your organization must have AI Lead Manager enabled.
To preview or execute a merge, or to preview or execute an unmerge, you need Edit permission on My Leads or All Leads.
Permission: Edit on My Leads β required to merge or unmerge leads assigned to you. Admin path: Lead Management > AI Lead Manager > Lead settings > (Security configuration)
Permission: Edit on All Leads β required to merge or unmerge any lead in the organization. Admin path: Lead Management > AI Lead Manager > Lead settings > (Security configuration)
To view merge history or list child leads, you need View permission on My Leads or All Leads.
Permission: View on My Leads or All Leads β required to access merge history and child lead lists.
Identify the survivor lead β the lead record that will remain active after the merge. All artifacts from the source leads move to the survivor unless you use selective merge.
Know which leads are source leads β the leads that will be merged into the survivor. Source leads become child records (marked as Duplicate or Merged) after the operation completes.
Preview a merge before committing
Run a merge preview to see which artifacts would move to the survivor lead and whether the leads are eligible to merge β without making any changes.
- Navigate to Lead Management > AI Lead Manager > All leads.
- Locate and open the lead you want to designate as the survivor.
- Initiate a merge preview from the lead's action menu.
- In the merge preview panel, specify:
- Survivor lead β the lead record that will remain after the merge.
- Source leads β one or more leads to merge into the survivor.
- Merge type β select FullData to move all artifacts, or Selective to choose specific artifacts.
- If using Selective merge, choose the artifacts to move.
- Review the preview results:
- Eligibility status β confirms whether the merge can proceed.
- Artifacts moving to survivor β lists the artifact IDs that would transfer.
- Artifacts staying β lists any artifacts that would remain on the source lead.
- If the merge looks correct, proceed to Merge leads. If not, adjust your selections and preview again.
Note: The preview is a dry run β no changes are saved to any lead record.
Merge leads
After previewing and confirming the outcome, execute the merge to commit the changes.
- Navigate to Lead Management > AI Lead Manager > All leads.
- Open the survivor lead record.
- Initiate the merge action from the lead's action menu.
- Complete the merge form:
- Survivor lead β confirm the lead that will remain active.
- Source leads β confirm the leads being merged in.
- Merge type β select FullData or Selective.
- Artifacts to move β if using Selective merge, select the specific artifacts to transfer.
- Reason (optional) β enter a note describing why the merge is being performed.
- Confirm and submit the merge.
- The system returns:
- A merge batch ID identifying the committed merge operation.
- A merge history entry you can review later.
- Queue identifiers for the background processing.
Important: Merging leads is a significant data operation. Always run a preview first to verify which artifacts will move before submitting.
Worked example: You have two leads for the same guest β Lead A (survivor, contains a booked appointment note and two tasks) and Lead B (source, contains an older email log). You select FullData merge and enter the reason "Duplicate from Meta integration." After submitting, the email log from Lead B moves to Lead A, and Lead B is marked Merged. The merge batch ID is recorded in merge history for audit reference.
View merge history
Merge history gives you a paginated record of all merge operations performed in your organization, with optional filters to narrow results.
- Navigate to Lead Management > AI Lead Manager > All leads.
- Open the merge history view from the lead management menu.
- Apply any of the available filters to narrow results β for example, filter by date range or survivor lead.
- Page through results to find the merge operation you need.
Note: Viewing merge history requires View permission on My Leads or All Leads. Users with only My Leads view access see history entries for leads assigned to them.
List child leads of a merged parent
After a merge, the source leads become child records linked to the survivor (parent) lead. You can list and filter these child leads to review what was merged.
Navigate to Lead Management > AI Lead Manager > All leads.
Open the survivor (parent) lead record.
Navigate to the child leads section of the lead detail view.
Filter child leads by status if needed:
Status Description Duplicate Lead was identified as a duplicate and merged into this parent Merged Lead was explicitly merged into this parent via a merge operation Attached Lead is associated with this parent without a full merge Page through results to review all child leads.
Note: Viewing child leads requires View permission on My Leads or All Leads.
Preview an unmerge operation
Before restoring a merged or attached lead to its original state, run an unmerge preview to confirm eligibility and see which artifacts would move back.
- Navigate to Lead Management > AI Lead Manager > All leads.
- Open the parent (survivor) lead record.
- Locate the child lead you want to unmerge in the child leads section.
- Select the unmerge preview option for that child lead.
- Review the preview results:
- Eligibility status β confirms whether the unmerge can proceed.
- Artifacts returning to restored lead β lists the artifact IDs that would move back to the child lead when it is restored.
- If the unmerge outcome is correct, proceed with the unmerge action. If not, cancel without making changes.
Note: Unmerge preview is available only for leads with a status of Merged or Attached. The preview is a dry run β no changes are saved.
Permission: Edit on My Leads or All Leads is required to preview an unmerge.
Unmerge a lead
Unmerging a Merged or Attached lead restores it to an independent state and returns its artifacts to it. Use the preview step first to confirm eligibility and the expected artifact movement before executing.
- Navigate to Lead Management > AI Lead Manager > All leads.
- Open the parent (survivor) lead record.
- Navigate to the child leads section and locate the child lead you want to unmerge.
- Initiate the unmerge action for that child lead.
- Confirm the operation when prompted.
- After the unmerge completes:
- The source lead is restored to an independent state, no longer linked to the parent.
- Artifacts that were transferred during the original merge are returned to the restored lead.
- The parent lead retains any artifacts that originated from it.
Important: Unmerge is only available for leads with a status of Merged or Attached. Leads with a status of Duplicate do not support unmerge. Always run a preview before executing to avoid unintended artifact movement.
Permission: Edit on My Leads or All Leads is required to execute an unmerge.
Tips
- Always preview before merging. The merge preview gives you artifact-level visibility into what will move. Reviewing eligibility status and artifact lists before committing prevents unintended data loss.
- Use Selective merge for partial consolidation. If only some artifacts from a source lead are relevant β for example, keeping a call log but not an outdated note β use Selective merge type and choose exactly which artifacts to transfer.
- Include a reason when merging. The optional reason field in the merge form is recorded in the merge history entry. A clear reason (for example, "Duplicate from Meta ad campaign β same phone number") makes it easier for other agents to understand the merge history during audits.
- Check child lead status after merging. After a merge completes, open the parent lead and review the child leads list to confirm source leads are showing the correct status (Duplicate or Merged) and that all expected artifacts are present on the survivor.
- Use merge history to audit operations. If a guest contacts you about missing information on their lead, the paginated merge history lets you trace which merge batch moved artifacts and when.
- Preview unmerge before executing. As with merging, the unmerge preview confirms eligibility and shows exactly which artifacts will return to the restored lead β review it before committing the operation.
Troubleshooting
| Problem | Resolution |
|---|---|
| Merge preview returns an ineligibility status | Verify that both the survivor and source leads exist and are not already in a terminal state (Won or Lost). Leads in terminal stages may not be eligible for merge. Check that you have Edit permission on the leads involved. |
| Artifacts do not appear on the survivor after merge | Allow a moment for background processing to complete β merge operations are queued and processed asynchronously. Refresh the survivor lead's detail view and check the notes, tasks, and timeline sections. If artifacts are still missing after a few minutes, review the merge batch ID in merge history to confirm the operation completed successfully. |
| Unmerge preview shows ineligible status | Unmerge is only available for leads with a status of Merged or Attached. If the child lead has a status of Duplicate, it may not support unmerge. Confirm the child lead's current status in the child leads section before attempting to unmerge. |
| Merge history does not show a recent merge | Confirm you have View permission on the relevant leads. Users with My Leads access see only merge history for their assigned leads. If the merge involved leads assigned to another agent, request All Leads view access or ask an administrator to review the history. |
| Cannot find child leads after a merge | Open the survivor lead and navigate to the child leads section. Ensure no status filter is restricting results β clear any active filters to show all child statuses (Duplicate, Merged, Attached). If the child leads section is not visible, confirm the merge batch completed by checking merge history. |
| Unmerge does not restore all artifacts | Run the unmerge preview on the child lead before executing to confirm which artifacts are eligible to return. If the preview shows fewer artifacts than expected, some artifacts may have been created on the survivor lead after the original merge and will remain there. |