Skip to content
Book a build

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.

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:

TopicWhat HubSpot says
SubscriptionEnterprise tier of Marketing, Sales, Service, Data, Content Hub, Smart CRM or Revenue Hub
PermissionsAccount access permissions to create, edit and manage custom objects
WhereData Management > Data Model > Edit data model, then add a custom object
Required setupSingular and plural names and a primary display property, which names each record
Fixed after creationThe internal name
LimitsDepend on the subscription; shown on the Limits tab of the data model
DeletingCan’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 trackUseExample
A fact about one contact, company or dealPropertyContract renewal date on a company
A type of person or companyProperty on the existing objectContact type: Parent, Teacher, Partner
How two existing records relateAssociation labelContact is the Billing contact for this company
A thing that has many instances per company or contact, each with its own dataCustom objectShipments, subscriptions, vehicles, properties for sale
A thing that moves through stages independently of dealsCustom object with a pipelineOnboarding projects, applications
A one-off interactionActivity (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.
  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. 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. To reuse an object you’ve already designed in another portal (see copying custom objects), 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.

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.

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.