GuideHow toSmart CRMData Hub

Enrich HubSpot companies from a spreadsheet when names don't match: import by Record ID

You have a spreadsheet of industry codes or segments for existing companies and no clean domain to match on. Matching by name is how you update the wrong company.

Subscription
Any tier (property creation needs property settings access)
Permissions
Import access and Edit property settings
Time
25 min · Intermediate
Last verified

Short answer

Name alone matches several companies. For a manufacturing client with a 700 row industry code spreadsheet, I exported company Record IDs, matched each row to exactly one company, kept the ambiguous rows out, and imported about 590 matched rows keyed on Record ID. Record ID overrides every other identifier in an import, so it updates exactly the record you meant.

1. Create the property first

I started from a spreadsheet of industry classification codes and a plain-language application for each company. Before importing, create the company property that will hold it. Here I used a multiple checkboxes property so one company can belong to several segments. Open Company properties and click Create property.

Property editor on the Field type step with Multiple checkboxes highlighted
Field type: Multiple checkboxes. This is a demo property.

Option labels and internal names matter because imports match on them. When the source terms are in another language, I stored the source term in each option's description and used the English label in the option itself.

Checkbox options list with labels and internal names highlighted
Labels and internal names for the five demo options.

2. Why the match must be by Record ID

The names in the file hit more than one company in the portal, and the file had no domains. HubSpot's import identifies a company by domain, or by Record ID, and Record ID supersedes everything else in the file. A row with no Record ID creates a new company, so keep unmatched rows out of this import.

Properties page filtered to Record ID with the property highlighted
Record ID is a default property on every object.

3. Export, match, import

  1. Export the companies you want to enrich, including Record ID, name, and domain.
  2. In the spreadsheet, match your rows to the export. Keep only rows that match exactly one company, and park the rest for a human.
  3. Start the import from Data integration, choose Import a file, and map the Record ID column to the Record ID property.
Data integration page with the Import a file card highlighted
The Import a file card. In this login the button is disabled because the user lacks import access.
Import in batches and verify

After the import, search for companies where the new property is known and compare the count to your matched rows. In the manufacturing project the counts matched at about 590 with zero failed batches.

Sources

New field notes by email

One email when a new article publishes.

Still stuck?

If this did not fix it, the problem is probably specific to your setup. Book a call and we will look at it together.

Book a call with Sam