Files
twenty/packages/twenty-docs/getting-started/core-concepts/data-model.mdx
T
5d438bb70c Docs: restructure navigation, add halftone illustrations, clean up hero images (#19728)
## Summary

- **New Getting Started section** with quickstart guide and restructured
navigation
- **Halftone-style illustrations** for User Guide and Developer
introduction cards using a Canvas 2D filter script
- **Removed hero images** (`image:` frontmatter + `<Frame><img>` blocks)
from all user-guide article pages
- **Cleaned up translations** (13 languages): removed hero images and
updated introduction cards to use halftone style
- **Cleaned up twenty-ui pages**: removed outdated hero images from
component docs
- **Deleted orphaned images**: `table.png`, `kanban.png`
- **Developer page**: fixed duplicate icon, switched to 3-column layout

## Test plan

- [ ] Verify docs site builds without errors
- [ ] Check User Guide introduction page renders halftone card images in
both light and dark mode
- [ ] Check Developer introduction page renders 3-column layout with
distinct icons
- [ ] Confirm article pages no longer show hero images at the top
- [ ] Spot-check a few translated pages to ensure hero images are
removed

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Co-authored-by: github-actions <github-actions@twenty.com>
2026-04-21 09:13:55 +02:00

44 lines
1.9 KiB
Plaintext

---
title: Data Model
description: Understand how Twenty structures your data with objects, fields, and relations.
icon: "database"
---
Everything in Twenty is built around **objects** and **fields** — the building blocks of your data model.
## Objects
Objects are the tables that hold your data. Twenty comes with standard objects out of the box:
- **Companies** — Organizations you do business with
- **People** — Individual contacts
- **Opportunities** — Deals in your pipeline
- **Tasks** — Action items for your team
- **Notes** — Free-form text linked to records
You can also create **custom objects** for anything your business needs — projects, support tickets, products, contracts, or anything else.
## Fields
Fields are the properties on each object. Twenty supports a wide range of field types:
| Category | Types |
|----------|-------|
| **Basic** | Text, Number, Boolean, Date, Currency, Rating, Select |
| **Composite** | Address (street, city, state, zip), Full Name, Links, Phones, Emails |
| **Special** | Relation, File Attachment, JSON, Actor (who created/modified) |
Every object also gets automatic system fields: `id`, `createdAt`, `updatedAt`, `createdBy`, and `position`.
## Relations
Objects connect to each other through relations. A Company has many People, an Opportunity belongs to a Company, and so on. You can create custom relations between any objects, including many-to-many relationships.
## What makes this powerful
Unlike traditional CRMs where you're limited to pre-defined fields on pre-defined objects, Twenty lets you model your data exactly the way your business works. Custom objects get the same first-class treatment as built-in ones — including API endpoints, views, permissions, and workflow triggers.
<Card title="Deep dive into the Data Model" icon="arrow-right" href="/user-guide/data-model/overview">
Full reference on objects, fields, relations, and how to configure them.
</Card>