When HubSpot sees a contact with a business email address and the automatic association setting is on, it compares the email domain with the Company domain name of your companies. If a company with that domain exists, the contact is associated with it; if not, HubSpot creates a company record for the domain, populates it with information from HubSpot's database, and associates the contact.
Checked against the HubSpot Knowledge Base on October 20, 2026.
For example, a contact with the email sandra@example.com is associated with the company whose Company domain name is example.com. The rest of this guide covers where the setting lives, what happens to existing contacts, how free email addresses and subdomains are handled, and how to keep the feature from creating duplicates.
What HubSpot does in each situation
| Situation | What HubSpot does |
|---|---|
| Business email, a company with that domain exists | Associates the contact with that company |
| Business email, no company with that domain | Creates a company, populates it from HubSpot's database, and associates the contact |
| Business email on a subdomain (info.example.com) | Treats it as its own domain and creates a separate company record |
| Freemail address (gmail.com, yahoo.com) with a Website URL | Uses the contact's Website URL to look for a matching company domain |
| Freemail address with no Website URL | No automatic association |
| Several companies share the same domain | Associates the contact with only one of them, and you cannot choose which |
| Contact already associated with a different company | Keeps the existing association |
| Contacts and companies associated in a multiple object import | Keeps the imported associations and does not create companies for contacts left without one |
HubSpot lists the setting as available with all products and plans.
How to turn on automatic company creation and association
- In your HubSpot account, click the settings icon in the top navigation bar.
- In the left sidebar menu, in the Data Management section, click Objects.
- Click the Select an object dropdown menu and select Companies.
- In the Automation section, select the Create and associate companies with contacts checkbox.
- In the dialog box, choose how to treat contacts already in your account:
- Yes retroactively creates company records and associates existing contacts based on their email addresses. New contacts are associated too.
- No applies the setting only to new contacts. Existing contacts are not affected.
There is one checkbox. HubSpot does not offer a separate "associate only, never create" option, so if you turn the setting on, it both creates and associates.
Should you pick Yes or No for existing contacts?
Pick No if your existing data has not been cleaned. Choosing Yes applies the rules to your existing contacts, so old contacts with outdated or misspelled email domains will produce companies too. A safer order is to clean domains, set up excluded domains, turn the setting on with No, and then associate older contacts in batches you have reviewed.
Free email addresses: the Website URL fallback
A common belief is that HubSpot simply ignores Gmail and Yahoo contacts. That is only half true. When the Email property holds a freemail domain, HubSpot looks at the contact's Website URL property and tries to match it to a company's domain. The contact stays unassociated only when the email is freemail and Website URL is empty.
This matters for B2B forms that accept personal emails. If you ask for the company website on the form and map it to the contact's Website URL, those contacts can still be matched to the right company.
Domain matching: subdomains, www and multiple domains
HubSpot creates a company record for each unique domain, including subdomains. A contact at @example.com and a contact at @info.example.com end up on two different companies.
Three rules help you keep matching clean:
- Store root domains only. HubSpot asks you to use the company's primary root domain, such as example.com, without "http://", "https://", a "www." prefix, page paths or a trailing slash. The Company domain name property is what matching runs on, and filling in Website URL on a company also fills in Company domain name.
- Add extra domains to one company. A company record can hold several domains. Contacts with any of those email domains are associated with the same company when automatic association is on, and their logged emails land on the same timeline.
- The primary domain decides duplicates. HubSpot uses the primary Company domain name value to identify company records. You can make a secondary domain primary from the company record by editing Company domain name, clicking Actions, and selecting Make primary.
Adding a domain to a company does not merge it with another company that already has that domain, and it only applies going forward. If a subdomain has already created a second company, merge the two. When you merge companies, the primary company keeps its domain and the other company's domain is added as a secondary domain.
How HubSpot deduplicates companies by domain
HubSpot automatically deduplicates companies by Company domain name, using the primary domain value:
| How the company is added | Deduplication behavior |
|---|---|
| Manual creation | HubSpot alerts you that a company with that primary domain already exists |
| Form with company properties | Updates the company matching the domain, or creates one if no domain matches |
| Import | Uses primary and secondary domains, unless you chose a custom unique value property as the identifier |
| API, including third-party sync apps | Not deduplicated by Company domain name |
The API row is the one that catches teams out. If an integration creates companies through the API and the automatic setting creates companies from contacts, you can end up with two records for one domain. HubSpot does not recommend turning on automatic association if the HubSpot-Salesforce integration is on, because it can create duplicate company records.
Once two companies share a domain, new contacts with that domain go to only one of them, and you cannot choose which. Fix the duplicates rather than working around them. The duplicates manager (on the companies index page, click the three vertical dots and select Manage duplicates) needs a Professional or Enterprise subscription, and it compares Company domain name, Company name, Country/Region, Phone number and Industry by default.
The primary company and what the association drives
For contacts, the first company you associate becomes the primary company by default, and a contact with only one associated company must have it as primary. So when automatic association links a contact that had no company, that company becomes the primary one.
The primary company matters more than it looks:
- Logged emails, calls and other timeline activities are automatically associated with only the primary company.
- Segments, workflows, cross-object reports and personalization tokens reference the primary association.
- If you sync company lifecycle stages with contacts or deals, only the primary company's stage is used.
- For tickets, the contact's primary company is associated automatically unless you turned that setting off.
That is also the answer to a frequent question about Gmail or Outlook logging: emails you log are associated with the contact and with the contact's primary company, so getting the automatic association right decides which company timeline shows the thread.
Forms with company fields
Forms follow their own rule. Whatever your automatic association setting and excluded domains, if a form submission includes company properties, the contact is associated with the company in the submission. If the submission has company properties but no Company domain name, and the contact's email domain matches an existing company, the contact is associated with that company.
Exclude domains and turn the setting off
You can exclude up to 1,000 domains. Use this for domains you never want turned into companies, such as your own company's domain or partner and agency domains.
- Go to Settings > Data Management > Objects and select Companies.
- Under the checkbox, click Exclude a domain out of automatic association.
- In the Opted out domains field, enter the domains and click Save.
To remove a domain from the list, click the X next to it and save. If you want that domain associated automatically again, you also need to clear the Create and associate companies with contacts checkbox and select it again.
To turn the feature off, clear the same checkbox. From then on, companies are not created or associated automatically from email domains, and existing records stay as they are. You can still create and associate companies manually and with other HubSpot tools.
What the setting does not do
- It does not assign owners or route leads. HubSpot's documentation describes creating, populating and associating companies only, so ownership needs its own rules, such as a workflow.
- It does not override an existing association that differs from the email domain, and in that case it does not sync company values such as Company name to the contact.
- It does not decide which of several same-domain companies gets the contact.
How to audit companies created by this setting
Companies created by the setting carry CRM Setting in the Record Source property, and Record Source Detail 1 names the "Create and associate companies with contacts" setting. HubSpot's change sources list defines CRM Setting as a HubSpot setting, "for example the setting to automatically create and associate companies with contacts." That is the "created from CRM setting" text you may see on a company.
A simple monthly check:
- On the companies index page, filter Record Source is CRM Setting and sort by Create date to review new companies.
- Look for subdomains, typos and freemail domains, then merge or delete them and add the bad domains to Opted out domains.
- Open Manage duplicates (Professional or Enterprise) to catch pairs sharing a domain.
- Review your enrichment settings under Settings > Data Management > Data Enrichment. Automatically enrich new records controls enrichment for newly created records, and Opt out of free company name enrichment stops HubSpot from filling the default Company name on new companies. Configuring these settings needs Super Admin permissions.
A worked example (hypothetical)
Imagine a 25-person software reseller that has 4,000 contacts and has never associated companies.
- It cleans obvious typos in email domains and adds its own domain and two agency domains to Opted out domains.
- It turns on Create and associate companies with contacts and clicks No in the dialog, so only new contacts are affected at first.
- It adds a required "Company website" field to its demo form, mapped to the contact's Website URL, so Gmail sign-ups can still match.
- After a week, it filters companies by Record Source is CRM Setting, finds a few subdomain companies, and merges them into the root domain companies.
- Once the new-contact flow looks clean, it associates older contacts in reviewed batches.
The team ends up with company timelines that show every logged email from each account, without anyone linking records by hand.
Getting help with your HubSpot data model
INSIDEA is an Elite HubSpot Partner and the growth operating system for modern businesses. If your company records, duplicates or association rules need a review, our HubSpot team can work through them with you.




