Back to the guides

PRACTICAL SOFTWARE GUIDE

HubSpot record merges: choose the primary record and reconcile retained values

A merge is irreversible, so preserve identifiers and decide which values and relationships must survive before combining records.

SOURCE-BASED ANALYSIS · NO HANDS-ON RATING

Confirm that the pair represents one real entity

HubSpot can surface potential duplicate contacts and companies, but similarity is a review signal rather than proof that two records should become one. Compare stable identifiers, authorized contact details, company domains and relationship context. Two people with similar names or two divisions sharing a domain may need separate records.

Record the primary decision before merging

HubSpot describes the record selected first as the primary record and generally prioritizes its property values, with documented exceptions. A merge creates a resulting record identity, combines activities and associations, and cannot be undone through an unmerge operation. Export or record the relevant state before proceeding.

ControlPrimary candidateSecondary candidate
Business identityVerified customer recordDuplicate import record
Required valuesApproved owner and statusNew phone requiring review
RelationshipsActive deal and companyRecent form activity

This is a fictional review example, not a real customer merge.

Reconcile more than the visible name

  1. Save the original Record IDs and URLs.
  2. Confirm both records represent the same entity.
  3. Choose the primary record and values to retain.
  4. Inventory important activities, associations and dependent processes.
  5. Perform the authorized merge.
  6. Verify the resulting ID, selected values, associations and recent activity.
  7. Search for the original IDs and document the decision.

Review downstream effects

The official documentation describes object-specific merge behavior and notes that workflow or integration effects can depend on the connected feature and subscription. Inspect the processes actually used by the account. Do not infer that combining two CRM rows also reconciles every external application.

For a controlled sample, compare a normal duplicate, a false positive and a pair with conflicting values. Reject the false positive and retain the reason. Accept the merge only when the surviving record preserves the approved meaning and the necessary relationships. This guide is an editorial checklist, not evidence that a live HubSpot merge was performed.

Sources and verification

Official documentation checked on 2026-10-29. Worked examples are hypothetical planning exercises, not measured product benchmarks.

Continue your evaluation

Practical guides for this topic

Put your tools to work.

Need help choosing or setting up your tools? Tell Koldia what you want to improve.

Discuss your project