User Guide

Getting Started
Views
Collaboration
Integrations
Settings
Other

Developers

Customize your data model

Customize your data model

Customize your data model
In this article

Learn how to design and create a data model that reflects how you operate.

What is a data model?

A data model is the structure that defines how information is organized in your CRM. It determines what objects exist (like companies, people, or deals), what properties they have (those are the fields), and how they relate to each other. You can think of it as the map of your customer data.

Why should you customize your data model?

Every business works differently. Being able to fully customize your data model means you can shape Twenty around your processes instead of forcing yours into a rigid system.
Twenty offers the flexibility you need to shape the data model that will best support your day-to-day. You can create as many custom objects and fields as you need - the price won't change.

Tips to design your data model

There is rarely only one way to build a data model. Below are a few tips to help you build yours.

1. Start with your core objects.
Identify the main things you work with (e.g. Companies, People, Opportunities). Those are already available as they are used very often. But think of any other you might need.

2. Use fields for variations, not new objects.
If something is just a characteristic of an existing object (e.g. “Industry” for a Company, or “Status” for an Opportunity), make it a field. Fields are best for categories, labels, and attributes.

3. Create a new object when it stands on its own.
If the concept has its own lifecycle, properties, or relationships, it usually deserves an object. For example:

  • Projects that have their own deadlines, owners, and tasks
  • Subscriptions that connect Companies, Products, and Invoices
  • Events that involve many Attendees and follow-up actions

These go beyond a single field because they carry their own data and relationships.

4. Create an object when the number of related records is open-ended.
If something can be linked multiple times and you don’t know how many, it’s better as its own object. For instance, instead of creating fields like “Product 1,” “Product 2,” etc., define a Product object and relate it to the original record. This way, you can support one, two, or a hundred products without changing your model.

5. Keep it simple first.
Start with fields. Move to new objects only when you feel the limits — too many fields, repeated records, or relationships that don’t fit neatly.


Special note on People and Companies

  • People and Companies are the only two objects from where you can access emails and meetings. We recommend using these as much as possible. If you need to create categories of People or Companies, use fields rather than new objects.
  • Example: it is best to use the People object for both prospects and partners, adding a field called Person Type. Avoid creating a Partner object, since you wouldn’t be able to access email threads from it. Instead, create different views under People — one showing Partners, another showing Prospects.
  • Given the point above, it’s fine to have fields that don’t apply to every record. For example, under People you might add a Referral Link field that is only relevant when Person Type = Partner. That’s okay — you can hide this field from views where it doesn’t matter.

Questions to guide your choice

Ask yourself:

  • Is this just a property of something I already have, or does it need its own properties?
  • Will I ever need to track multiple of these per record, without knowing how many in advance?
  • Does this concept connect to several different objects, not just one?
  • Will it have its own lifecycle (e.g. stages, start/end dates)?

If the answer is “yes” to one or more of these, it’s probably time for a new object.

Want some help?

Our team can assist you designing and creating the data model you need. Discover our Onboarding Pack here.

FAQ

  • Where can I see and edit my data model?
    • You can access your Data Model under the Settings.
  • Why can't I see the Data Model under the Settings?
    • Reach out to your workspace admin, data model is usually only accessible by admins.
  • How many custom objects or fields can I create?
    • You can create as many custom objects and fields as you need - the price won't change.

Noticed something to change?

As an open-source company, we welcome contributions through Github. Help us keep it up-to-date, accurate, and easy to understand by getting involved and sharing your ideas!

twenty github image
The #1 Open Source CRM
©2025 Twenty PBC