Skip to content
Book a build

What are HubSpot association labels and when should you use them?

HubSpot association labels describe how two associated records relate, such as Billing contact, Decision maker or Parent and Child company. You create them for an object pair in the data model, use them in segments, workflows and reports, and set limits on how many records each side can have. They need a Professional or Enterprise subscription, and only Super Admins can create them.

On this page

What HubSpot supports natively

An association says two records are connected. A label says how. HubSpot’s rules:

TopicWhat HubSpot says
SubscriptionProfessional or Enterprise (Marketing, Sales, Service, Data, Content Hub or Smart CRM)
PermissionsSuper Admin to create labels
LimitUp to 50 labels per object pair; a paired label counts as one
Single labelBoth sides use the same word, e.g. Colleague or Partner
Paired labelsEach side has its own word, e.g. Parent and Child; setting one sets the other
Association limitsPer direction: Many, or a custom number of records
Where they’re usedSegment filters, workflow triggers, branches and actions, report axes, breakdowns and filters
DeletingPermanent; remove the label from records and tools first

When to use association labels

Use a label when the relationship itself carries meaning that a property on either record can’t hold:

SituationUseWhy
A contact is the billing contact for one company and a user at anotherLabel on contact-to-companyThe role differs per company, so it can’t be a contact property
A deal has a decision maker, a champion and a blockerLabels on contact-to-dealWorkflows can email only the decision maker
A franchise company has many location companiesPaired labels Parent and Child on company-to-companyReports can roll up by parent
A contact is a “VIP”Property on the contactIt’s true of the contact everywhere
A deal has exactly one primary contactLabel with a limit of 1The limit stops a second one being added

How to set up association labels

  1. List the relationships that drive actions: who gets which email, who owns which renewal, which company rolls up into which.
  2. Decide single or paired for each. If the two sides need different words, use a paired label.
  3. Create them in the data model or object settings as a Super Admin, and set association limits where only one record should hold the role.
  4. Add them to imports with an Association label column. See importing contacts and companies together.
  5. Use them: build a segment that filters on the label, or a workflow that emails only the contacts with it.
  6. Document each label’s meaning, since nothing in HubSpot explains what Partner means to your team.

Common mistakes

  • Using labels as tags. If it’s about one record, use a property.
  • Too many near-duplicates like Decision maker and Decision-maker. Agree names before creating them.
  • No limits on roles that should be unique. Without a limit, two contacts can both be the primary.

Where Jetstack AI fits

To set up new labels, use Jetstack AI’s Projects: name the labels and the objects they connect in a brief (for example “Billing contact” and “Decision maker” between contacts and companies), approve the plan, then approve deployment separately. Labels are built alongside the properties and custom objects they connect, and the receipt confirms each one by reading it back from HubSpot. Projects is currently in limited release; see what Projects can build. To copy labels to another portal, Portal reuse imports user-defined labels, creates both directions of a paired label, remaps custom object IDs and skips labels that already exist in the destination. Setting a label’s limit is attempted afterwards and is reported as a warning if HubSpot refuses it. See how association labels are deployed.

Sources

Checked October 29, 2026. HubSpot changes its products often; tell us at team@jetstack.ai if something here is out of date.

HubSpot admin

Turn the brief into approved HubSpot assets.

Projects plans the build against the client portal, generates the assets and deploys them only after you approve.

Explore Projects

HubSpot admin

Related questions.

What are HubSpot association labels and when should you use them?

HubSpot association labels describe how two associated records relate, such as Billing contact, Decision maker or Parent and Child company. You create them for an object pair in the data model, use them in segments, workflows and reports, and set limits on how many records each side can have. They need a Professional or Enterprise subscription, and only Super Admins can create them.

How many association labels can I create?

Up to 50 labels per object pair, such as Contact to Deal or Contact to Contact. A paired label counts as one label toward that limit.

Can I restore a deleted association label?

No. Deleting a label is permanent, and if it's used in records or tools you have to remove it from those first.

Can I set association labels in an import?

Yes, with a Professional or Enterprise subscription. Create the labels in HubSpot first, then add an Association label column to the file; use Primary to mark a company as primary and separate several labels with semicolons.