On this page
What HubSpot supports natively
Prevention (all plans):
- Contacts are deduplicated on email. You can’t manually create a second contact with the same email, and a form submission with a known email updates the existing contact.
- Companies are matched on the primary Company domain name. Companies created through the API aren’t deduplicated this way.
- Record ID deduplicates any object on import. Rows without one create new records unless another identifier matches.
- Unique value properties: up to ten custom properties per object can require unique values, such as a customer number. These aren’t supported in forms.
Finding and merging (Manage duplicates tool):
| Capability | Subscription |
|---|---|
| Review individual duplicate pairs, up to 10,000 shown | Professional or Enterprise |
| Bulk merge and reject, up to 30,000 pairs | Data Hub Professional |
| Bulk merge and reject, up to 100,000 pairs | Data Hub Enterprise |
| Custom duplicate rules and the audit log | Data Hub Professional or Enterprise |
HubSpot compares records daily. The default rules look at name, email, IP country, phone, zip code and company name for contacts, and domain, name, country, phone and industry for companies. You need data quality tools access plus edit permission for all contacts or all companies, or Super Admin.
What a merge does: by default the primary record’s property values win and the secondary’s fill any gaps, but several properties follow their own rules:
| Property | Kept after the merge |
|---|---|
| Lifecycle stage | The stage furthest down the funnel, from either record |
| Original traffic source | The oldest value, unless it was manually updated |
| Create date | The oldest |
| Number of conversions, unique forms submitted | Summed; analytics properties are re-synced |
| Marketing contact status | The most marketable status |
The secondary’s email (or domain) becomes a secondary email (or domain). Timeline activity and associations from both records move to the merged record. The merged record gets a new Record ID, unless your account is in HubSpot’s Primary ID Preservation beta.
How to merge duplicate contacts and companies
- Back up first. Export the contacts and companies involved, or take a CRM backup. Merges can’t be reverted.
- Fix the source. Find what creates the duplicates: a form, an import without Record ID or email, or an integration creating companies by API.
- Open Manage duplicates from the Actions menu on the Contacts or Companies index page.
- Review pairs, starting with the most valuable records (customers, open deals). Choose the primary record deliberately; its values win for ordinary properties such as owner, name and phone.
- Reject false positives so they stop reappearing. Rejections can be undone within 14 days.
- Bulk merge (Data Hub) only after you’ve checked a sample manually, and choose the merge criteria, such as most recent engagement or created first.
- Check integrations and workflows that store Record IDs, since the merged record’s ID usually changes.
Common mistakes
- Expecting the primary to win everywhere. Owner and other ordinary properties follow the primary, but lifecycle stage keeps the furthest stage and original traffic source keeps the oldest value from either record. A merge can move a contact forward a stage; it never moves one back.
- Merging companies that are really parent and child. Use a parent-child association instead.
- Cleaning once without fixing imports. Add Record ID or email to every update import; see the import template.
Where Jetstack AI fits
Jetstack AI’s Portal Audit measures duplicate contacts and companies, missing critical properties and stale records as part of its Data Quality block, so you know the size of the problem before you start. It doesn’t merge records; that stays in HubSpot. See the Data Quality data points.
Sources
- Deduplication of records (HubSpot Knowledge Base)
- Manage duplicate records (HubSpot Knowledge Base)
- Merge records (HubSpot Knowledge Base)
- Portal Audit: General data points (Jetstack AI documentation)
Checked October 30, 2026. HubSpot changes its products often; tell us at team@jetstack.ai if something here is out of date.
HubSpot admin
See what needs work before you change it.
A read-only Portal Audit and Workflow Audit score the portal, trace dependencies and turn findings into a branded report.
Explore Portal Audit