Understanding objects
The fundamental building blocks of Attio.
What are objects?
In Attio, there are two types of objects: standard objects and custom objects.
Standard objects
An object is a data structure that allows you to organize and present data in a certain way. It’s the equivalent of a table within a spreadsheet. You could also think of it as a blueprint for you how store your data.
A standard object is an object that is natively supported by Attio. There are 5 standard objects:
Object | Use Case | Enabled by default? |
---|---|---|
People | Stores information about any person who interacts with your business. | Yes |
Companies | Stores information about any company that interacts with your business. | Yes |
Deals | Tracks potential sales between your company and another organization or individual. | No |
Workspaces | Tracks information about accounts using your product, including connected users and companies. | No |
Users | Tracks information about the users of your product, including the person and workspace records they are connected to. | No |
Each standard object comes with a pre-defined set of attributes, which you can find in Workspace settings > Objects
.
Attio has two standard objects enabled by default: People
and Companies
, and three other standard objects that you can activate: Deals
, Workspaces
and Users
. We’ll dive into the reasons for why you might use these in a later section.
You can activate other standard objects (as well as custom objects) by going to Workspace settings > Data > Objects
.
Custom objects
A custom object is exactly what it sounds like: a data structure that is customized uniquely for your business.
If Attio’s standard objects don’t align close enough with your business model, then you can easily create a custom object that aligns exactly to your needs.
How to create a custom object
To create a custom object, go to Workspace settings > Data > Objects
and click Create custom object
.
You’ll need to name the entity you are tracking. For example, if you’re a B2B SaaS company, it might be subscriptions. In this case, your plural noun will be Subscriptions
and your singular noun Subscription
.
You’ll also want to choose an identifier that will also serve as a slug. We recommend choosing something as close as possible to your noun (in this case, /subscriptions
).
When should I use a custom object?
You should use custom objects if your data and workflow structures don’t work neatly with standard objects. Custom objects allows you to mold your CRM exactly to your business and data model.
For example, if you’re a B2B marketplace, you may want to create custom objects for Buyers
, Sellers
, and Transactions
, in addition to the Attio Standard Objects of People
, Deals
, and Companies
.
Example: B2B marketplace
Type | Object | Description |
---|---|---|
Custom | Buyers | Those purchasing your products/services in your marketplace. |
Custom | Sellers | Those selling products/services in your marketplace. |
Custom | Transactions | Data store for every transaction that occurs. |
Standard | People | Contacts who you deal with on the non-marketplace side of your business. |
Standard | Companies | Companies who you deal with on the non-marketplace side of your business. |
Standard | Deals | A potential sale that your business wants to track between your company and another organization or individual . |
Object relationship types
One of the most powerful aspects of objects is that you can specify their relationship types. This allows you to define how objects are connected and interact with each other. In Attio, there are three types of object relationships:
For example, in the case of our B2B marketplace, you’d want your Buyers
object to have a one to one
relationship with Companies
, and a one to many
relationship with Transactions
.
This setup lets you see at a glance who a buyer is working with and all the deals they're involved in.
If we were to sketch out our complete data model for our B2B marketplace, it would look like this:
Object | Relationship Type | Object |
---|---|---|
Buyers | one to one | Companies |
Buyers | one to many | Transactions |
Sellers | one to one | Companies |
Sellers | one to many | Transactions |
Companies | one to many | People |
Companies | one to many | Deals |
In our B2B marketplace data model:
Defining the relationships between your objects creates a clear structure for your data and leads to better growth, management, processes, and insights into how different parts of your business work together.
Learn more
For an even deeper dive about objects, reference the Objects article in our Reference section.
Up next
Learn in more depth about attributes.