Files
twenty/packages/twenty-docs/docs/user-guide/basics/custom objects.mdx
2023-12-10 18:10:54 +01:00

43 lines
2.1 KiB
Plaintext

---
title: Creating Custom Objects
sidebar_position: 1
sidebar_custom_props:
icon: TbAugmentedReality
---
Objects are structures that allow you to store data (records, attributes, and values) specific to an organization. Twenty provides both standard and custom objects.
Standard objects are in-built objects with a set of attributes available for all users. All workspaces come with three standard objects by default: People, Companies, and Opportunities. Standard objects have standard fields that are also available for all Twenty users, like Account Owner and URL.
Custom objects are objects that you can create to store information that is unique to your organization. They are not built-in; members of your workspace can create and customize custom objects to hold information that standard objects aren't suitable for. For example, if you're Airbnb, you may want to create a custom object for Listings or Reservations.
## Creating a new custom object
To create a new custom object:
1. Go to Settings in the sidebar on the left.
2. Under Workspace, go to Data model. Here you'll be able to see an overview of all your existing Standard and Custom objects (both active and disabled).
<br/>
<div style={{textAlign: 'center'}}>
<img src="/img/user-guide/view-all-objects.png" alt="View all objects" />
</div>
<br/>
3. Click on `+ New object` at the top, then choose Custom as the object type. Enter the name (both singular and plural) and description for your custom object and hit Save (at the top right). Using Listing as an example of custom object, the singular would be "listing" and the plural would be "listings" along with a description like "Listings that hosts created to showcase their property."
<br/>
<div style={{textAlign: 'center'}}>
<img src="/img/user-guide/create-custom-object.gif" alt="Create custom object" />
</div>
<br/>
4. Once you create your custom object, you'll be able to manage it. You can edit the name and description, view the different fields, and add more fields.
<div style={{textAlign: 'center'}}>
<img src="/img/user-guide/manage-custom-object.png" alt="Create custom object" />
</div>