---
title: "HubSpot association labels explained"
description: "HubSpot association labels explained: single vs paired labels, the 50-per-pair limit, who can create them, and how to use them in workflows and reports."
url: "https://jetstack.ai/answers/hubspot-association-labels/"
---

# 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.

![](https://jetstack.ai/images/authors/aditya-kumar.webp)

By [Aditya Kumar](https://jetstack.ai/authors/aditya-kumar/) Founder, Jetstack AI

Updated October 29, 2026

On this page

## What HubSpot supports natively

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

| Topic              | What HubSpot says                                                                             |
| ------------------ | --------------------------------------------------------------------------------------------- |
| Subscription       | Professional or Enterprise (Marketing, Sales, Service, Data, Content Hub or Smart CRM)        |
| Permissions        | Super Admin to create labels                                                                  |
| Limit              | Up to 50 labels per object pair; a paired label counts as one                                 |
| Single label       | Both sides use the same word, e.g. Colleague or Partner                                       |
| Paired labels      | Each side has its own word, e.g. Parent and Child; setting one sets the other                 |
| Association limits | Per direction: Many, or a custom number of records                                            |
| Where they’re used | Segment filters, workflow triggers, branches and actions, report axes, breakdowns and filters |
| Deleting           | Permanent; 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:

| Situation                                                              | Use                                                      | Why                                                             |
| ---------------------------------------------------------------------- | -------------------------------------------------------- | --------------------------------------------------------------- |
| A contact is the billing contact for one company and a user at another | **Label** on contact-to-company                          | The role differs per company, so it can’t be a contact property |
| A deal has a decision maker, a champion and a blocker                  | **Labels** on contact-to-deal                            | Workflows can email only the decision maker                     |
| A franchise company has many location companies                        | **Paired labels** Parent and Child on company-to-company | Reports can roll up by parent                                   |
| A contact is a “VIP”                                                   | **Property** on the contact                              | It’s true of the contact everywhere                             |
| A deal has exactly one primary contact                                 | **Label with a limit of 1**                              | The 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](https://jetstack.ai/answers/import-contacts-companies-together-hubspot).
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](https://jetstack.ai/build): 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](https://jetstack.ai/docs/projects/capabilities). To [copy labels to another portal](https://jetstack.ai/answers/copy-hubspot-association-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](https://jetstack.ai/docs/implementations/asset-types/association-labels).

## Sources

- [Create and use association labels (HubSpot Knowledge Base)](https://knowledge.hubspot.com/object-settings/create-and-use-association-labels)
- [Set up your import file (HubSpot Knowledge Base)](https://knowledge.hubspot.com/import-and-export/set-up-your-import-file)
- [Association labels (Jetstack AI documentation)](https://jetstack.ai/docs/implementations/asset-types/association-labels)

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

![Aditya Kumar](https://jetstack.ai/images/authors/aditya-kumar.webp)

About the author

[Aditya Kumar](https://jetstack.ai/authors/aditya-kumar/)

Founder, Jetstack AI

Aditya Kumar is the founder of Jetstack AI, the AI platform HubSpot partners and RevOps teams use to audit portals, build implementations and reuse their best setups across portals. He writes about HubSpot architecture, automation and AI from the work of building it.

[More from Aditya](https://jetstack.ai/authors/aditya-kumar/) [LinkedIn](https://www.linkedin.com/in/aditya-ambrstack/)

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](https://jetstack.ai/build)

On this page

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.
