Files
twenty/packages/twenty-docs/user-guide/data-model/how-tos/create-custom-objects.mdx
T
StephanieJoly4GitHubcubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>github-actionsAbdul RahmanFélix Malfait
183d034716 User guide structure update (#16705)
Reorganizing by Feature sections

Capabilities folders to give an overview of each feature

How-Tos folders to give guidance for advanced customizations

Reorganized the Developers section as well, moving the API sub section
there

added some new visuals and videos to illustrate the How-Tos articles

checked the typos, the links and added a section at the end of the
doc.json file to redirect existing links to the new ones (SEO purpose +
continuity of the user experience)

What I have not updated is the "l" folder that, per my understanding,
contains the translation of the User Guide - that I only edited in
English

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> <sup>[Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) is
generating a summary for commit
5301502a32. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

---------

Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>
Co-authored-by: github-actions <[email protected]>
Co-authored-by: Abdul Rahman <[email protected]>
Co-authored-by: Félix Malfait <[email protected]>
2025-12-22 09:07:06 +01:00

51 lines
1.6 KiB
Plaintext

---
title: Create Custom Objects
description: Step-by-step guide to creating custom objects in Twenty.
---
Custom objects let you store information unique to your business that standard objects don't cover. For example: Projects, Products, Tickets, or Listings.
<Note>
**Not sure if you need an object or a field?** See [Understanding Your Data Model](/user-guide/data-model/overview) for guidance.
</Note>
## Steps
1. Go to **Settings → Data Model**
2. Click **+ New object**
3. Fill in:
- **Singular name** (e.g., "Listing")
- **Plural name** (e.g., "Listings")
- **Icon**
- **Description** (optional)
4. Click **Save**
Your object appears in the sidebar immediately.
## Next: Add Fields
New objects start with basic fields. Add custom fields to capture the data you need:
1. In **Settings → Data Model**, select your object
2. Click **+ Add Field**
3. Choose a field type, configure, and save
See [How to Create Custom Fields](/user-guide/data-model/how-tos/create-custom-fields) for details on field types and configuration.
## Connecting to Other Objects
To link your object to People, Companies, or other objects, create a relation field. See [How to Create Relation Fields](/user-guide/data-model/how-tos/create-relation-fields).
## Deactivating an Object
If you no longer need an object:
1. Go to **Settings → Data Model**
2. Toggle the object off
The object is hidden but data is preserved. You can reactivate or permanently delete later.
## Related
- [Objects](/user-guide/data-model/capabilities/objects) — standard vs custom objects
- [Data Model FAQ](/user-guide/data-model/how-tos/data-model-faq) — common questions