Contacts

How does HubSpot deduplicate contacts, companies, deals, and tickets?

Last updated: September 4, 2018

HubSpot deduplicates your records in a few different ways to keep your database clean. Contact and companies can both be deduplicated based on specific property values. Contacts may also be deduplicated by a usertoken set with a cookie in their web browser or by email address. Contacts, companies, deals, and tickets can all deduplicated by a unique record ID included in an export of these records.

Deduplicating contacts by usertoken

When a new contact is added to HubSpot through a form submission, HubSpot first looks at a contact's usertoken to see if it should be merged with an existing contact. The usertoken is the hubspotutk cookie that HubSpot stores in a visitor's browser when they view a page that includes your HubSpot tracking code.

Please note: if you've turned on GDPR functionality in your account, a user must accept your privacy policy banner in order for this cookie to be associated with their contact record.

If a visitor submits a form on one web browser, then another visitor submits a form using the same browser on the same computer, these contacts will be merged together. The information from the second form submission will overwrite the information from the first submission because they have the same cookie stored in their browser. This will happen only if the email address from the second submission doesn't already exist as a contact in HubSpot.

You can disable cookie tracking on your form if you want each form submission from the same browser to create a new contact. This can be useful in specific use cases, such as collecting contact details at a trade show on a single device.

Deduplicating contacts by email address

When a new contact is added through import, form submission, or API, HubSpot will look for a matching value in the Email property. If a contact exists with the same email address as the one being added, the new contact information will be added to the existing contact record.

For example, if you import a list of contacts that includes any email addresses already associated with existing contacts in HubSpot, the imported information will be added to the existing contact record.

Deduplicating companies by company domain

When a new contact is added through import, form submission, or API, HubSpot looks at the Company domain name property value to deduplicate companies. If a company with the same company domain name already exists in your account, the new company information will be added to the existing company record. 

If you do not include this property in your import, each row of your import file will be imported as a new company record.

Deduplicating contacts, companies, deals, or tickets by record ID

When a new contact, company, deal, or ticket is added through import you can use a unique record ID to match up these records with existing records in HubSpot. This record ID can be used to deduplicate records during the import process, or to search for a specific record in HubSpot.

search-by-object-id

To get the Contact ID, Company ID, Deal ID, or Ticket ID, you must first export your recordsWhen you receive your export file, the corresponding record ID will be listed in column 1. 

view-file

Include the Contact ID, Company ID, Deal ID, or Ticket ID column in your file when you import your records into HubSpot. During the import process, you'll click the Update existing [records] using "record ID" exported from HubSpot checkbox when you choose your file.

import-by-id

Please note: if you include the record ID column in your file, any rows that do not have a value for the record ID will be skipped during the import process. Contacts imported with the Contact ID won't update the Email property. Companies imported with the Company ID won't update the Company domain name property.

Was this article helpful?

If you still need help you can get answers from the , or to contact support.