---
title: "HubSpot custom objects: when to use them vs properties"
description: "When HubSpot custom objects beat properties or association labels: a decision table, the Enterprise requirement, and the mistakes HubSpot warns against."
url: "https://jetstack.ai/answers/hubspot-custom-objects/"
---

# When should you use HubSpot custom objects instead of properties?

Use HubSpot custom objects when the thing you track has its own records, its own lifecycle and a many-to-one or many-to-many relationship with contacts, companies or deals, such as shipments, subscriptions or properties for sale. If it describes a single existing record, use properties. If it describes how two existing records relate, use association labels. Custom objects need an Enterprise subscription.

![](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

A custom object is a new record type, with its own properties, associations and, optionally, pipelines. HubSpot’s rules:

| Topic                | What HubSpot says                                                                         |
| -------------------- | ----------------------------------------------------------------------------------------- |
| Subscription         | Enterprise tier of Marketing, Sales, Service, Data, Content Hub, Smart CRM or Revenue Hub |
| Permissions          | Account access permissions to create, edit and manage custom objects                      |
| Where                | Data Management > Data Model > Edit data model, then add a custom object                  |
| Required setup       | Singular and plural names and a primary display property, which names each record         |
| Fixed after creation | The internal name                                                                         |
| Limits               | Depend on the subscription; shown on the Limits tab of the data model                     |
| Deleting             | Can’t be restored, and blocked while other tools use the object                           |

HubSpot also asks you to check first whether an existing object and its properties can hold the data. It gives two examples of misuse: creating “Parents” and “Teachers” objects instead of contacts with a contact-type property, and building a “Notes” object instead of using activities.

## Custom object, property or association label?

| You need to track                                                              | Use                                                                             | Example                                                 |
| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------- | ------------------------------------------------------- |
| A fact about one contact, company or deal                                      | **Property**                                                                    | Contract renewal date on a company                      |
| A type of person or company                                                    | **Property** on the existing object                                             | Contact type: Parent, Teacher, Partner                  |
| How two existing records relate                                                | **[Association label](https://jetstack.ai/answers/hubspot-association-labels)** | Contact is the Billing contact for this company         |
| A thing that has many instances per company or contact, each with its own data | **Custom object**                                                               | Shipments, subscriptions, vehicles, properties for sale |
| A thing that moves through stages independently of deals                       | **Custom object with a pipeline**                                               | Onboarding projects, applications                       |
| A one-off interaction                                                          | **Activity** (note, task, call)                                                 | Site visit notes                                        |

A quick test: if you’d otherwise create numbered properties (*Vehicle 1 make*, *Vehicle 2 make*), you need an object. If each record would only ever have one value, a property is enough.

## How to set up a custom object well

1. **Write down the relationships first.** Which standard objects does it associate with, and how many on each side? Map it in the [data model overview](https://jetstack.ai/answers/hubspot-data-model-overview).
2. **Pick a stable internal name.** It can’t change later, and integrations will use it.
3. **Choose a primary display property** people recognise, such as an order number or a policy name.
4. **Add only the properties you’ll report on** at launch. More can come later.
5. **Create associations and labels** before importing records, so the import can link them.
6. **Add a pipeline** only if the object really moves through stages.

## Where Jetstack AI fits

To set up a new custom object, use Jetstack AI’s [Projects](https://jetstack.ai/build). Describe the object, its properties, association labels and pipeline in a brief; Jetty, the Projects assistant, turns it into a plan you approve, builds the object before anything that depends on it, and deploys after a separate approval, with a receipt checked by reading each asset back from HubSpot. Projects is currently in limited release; see [what Projects can build](https://jetstack.ai/docs/projects/capabilities). To reuse an object you’ve already designed in another portal (see [copying custom objects](https://jetstack.ai/answers/copy-hubspot-custom-objects-to-another-portal)), Portal reuse imports the full schema with its pipelines and user-defined association labels, deploys the object before anything that depends on it, and reuses a matching object if the destination already has one. See [how custom objects are deployed](https://jetstack.ai/docs/implementations/asset-types/custom-objects).

## Sources

- [Create custom objects (HubSpot Knowledge Base)](https://knowledge.hubspot.com/object-settings/create-custom-objects)
- [Track CRM data limits (HubSpot Knowledge Base)](https://knowledge.hubspot.com/data-management/track-crm-data-limits)
- [Custom objects (Jetstack AI documentation)](https://jetstack.ai/docs/implementations/asset-types/custom-objects)

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.

When should you use HubSpot custom objects instead of properties?

Use HubSpot custom objects when the thing you track has its own records, its own lifecycle and a many-to-one or many-to-many relationship with contacts, companies or deals, such as shipments, subscriptions or properties for sale. If it describes a single existing record, use properties. If it describes how two existing records relate, use association labels. Custom objects need an Enterprise subscription.

Which HubSpot subscription includes custom objects?

An Enterprise subscription of Marketing, Sales, Service, Data, Content Hub or Smart CRM, or Revenue Hub. How many objects and properties you can create depends on the subscription; HubSpot shows your limits under Data Management > Data Model > Limits.

Can I rename a custom object later?

You can edit the singular and plural names, the description and the display properties. The internal name can't be changed after the object is created, so choose it carefully.

Should I use a custom object to replace notes or tasks?

No. HubSpot specifically warns against rebuilding activities as custom objects; use notes, tasks and activity reporting instead.
