diff --git a/packages/twenty-docs/getting-started/core-concepts/ai.mdx b/packages/twenty-docs/getting-started/core-concepts/ai.mdx
index 2e97bb7e71..326cf28fd6 100644
--- a/packages/twenty-docs/getting-started/core-concepts/ai.mdx
+++ b/packages/twenty-docs/getting-started/core-concepts/ai.mdx
@@ -4,12 +4,16 @@ description: How Twenty uses AI to enhance your CRM experience.
icon: "robot"
---
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
Twenty integrates AI directly into your CRM — not as a gimmick, but as a tool that works within your data model and permission system.
## AI Chatbot
Ask questions about your data in natural language. The AI chatbot can query your CRM records, summarize information, and help you find what you're looking for without building complex filters.
+
+
## AI Agents
AI agents go beyond chat — they can execute multi-step tasks autonomously:
diff --git a/packages/twenty-docs/getting-started/core-concepts/apps.mdx b/packages/twenty-docs/getting-started/core-concepts/apps.mdx
index b221036efc..da04ff63fd 100644
--- a/packages/twenty-docs/getting-started/core-concepts/apps.mdx
+++ b/packages/twenty-docs/getting-started/core-concepts/apps.mdx
@@ -4,6 +4,7 @@ icon: "cube"
description: Extend Twenty with code — custom objects, server-side logic, UI components, and AI agents, all as TypeScript packages.
---
+
Most CRMs give you a config panel. Twenty gives you a platform. Apps are how developers extend Twenty beyond what the UI offers — defining data models, server-side logic, UI components, and AI capabilities as code, then deploying them to one or more workspaces.
## Why apps exist
diff --git a/packages/twenty-docs/getting-started/core-concepts/dashboards.mdx b/packages/twenty-docs/getting-started/core-concepts/dashboards.mdx
index 150c95f758..7835d5483e 100644
--- a/packages/twenty-docs/getting-started/core-concepts/dashboards.mdx
+++ b/packages/twenty-docs/getting-started/core-concepts/dashboards.mdx
@@ -4,7 +4,10 @@ description: Track performance and visualize your CRM data with custom dashboard
icon: "chart-bar"
---
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
Dashboards give you real-time visibility into your business metrics — pipeline health, team performance, revenue trends, and anything else you want to track.
+
## Widgets
diff --git a/packages/twenty-docs/getting-started/core-concepts/data-model.mdx b/packages/twenty-docs/getting-started/core-concepts/data-model.mdx
index efc7f829ce..45b652652e 100644
--- a/packages/twenty-docs/getting-started/core-concepts/data-model.mdx
+++ b/packages/twenty-docs/getting-started/core-concepts/data-model.mdx
@@ -4,6 +4,8 @@ description: Understand how Twenty structures your data with objects, fields, an
icon: "database"
---
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
Everything in Twenty is built around **objects** and **fields** — the building blocks of your data model.
## Objects
@@ -41,3 +43,5 @@ Unlike traditional CRMs where you're limited to pre-defined fields on pre-define
Full reference on objects, fields, relations, and how to configure them.
+
+
diff --git a/packages/twenty-docs/getting-started/core-concepts/layout.mdx b/packages/twenty-docs/getting-started/core-concepts/layout.mdx
index f9e69ba616..6e94ee6902 100644
--- a/packages/twenty-docs/getting-started/core-concepts/layout.mdx
+++ b/packages/twenty-docs/getting-started/core-concepts/layout.mdx
@@ -4,6 +4,8 @@ description: How to navigate, browse, and view records in Twenty.
icon: "table-columns"
---
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
## The main layout
The center of the screen is where your records live — people, companies, opportunities, tasks, notes, dashboards, workflows, and any custom objects. You view, edit, and delete records here, and create new views.
@@ -66,3 +68,6 @@ When you open a record, the detail page is built from configurable **tabs** and
Navigation, views, record pages — detailed reference and how-tos.
+
+
+
diff --git a/packages/twenty-docs/getting-started/core-concepts/workflows.mdx b/packages/twenty-docs/getting-started/core-concepts/workflows.mdx
index 77e8d893a2..88ac34f26f 100644
--- a/packages/twenty-docs/getting-started/core-concepts/workflows.mdx
+++ b/packages/twenty-docs/getting-started/core-concepts/workflows.mdx
@@ -4,8 +4,13 @@ description: Automate your business processes with Twenty's visual workflow buil
icon: "bolt"
---
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
Workflows let you automate repetitive tasks and connect Twenty to external tools — without writing code (though you can if you want to).
+
+
+
## How workflows work
Every workflow has three parts:
diff --git a/packages/twenty-docs/getting-started/introduction.mdx b/packages/twenty-docs/getting-started/introduction.mdx
index ff2fb56a44..cfe6868797 100644
--- a/packages/twenty-docs/getting-started/introduction.mdx
+++ b/packages/twenty-docs/getting-started/introduction.mdx
@@ -3,6 +3,7 @@ title: Why Twenty
icon: "heart"
---
+import { CardTitle } from "/snippets/card-title.mdx"
You've been choosing between software that's easy to start but impossible to change, and software that's flexible but takes months to set up. Twenty is the third option: **a production-ready CRM you can reshape as you go.**
@@ -12,17 +13,20 @@ You've been choosing between software that's easy to start but impossible to cha
Twenty is a platform you can build on, not a product you configure.
-
+
+ Built for Agents
Agents operate inside your data model with real permissions. Skills, Tools, MCP.
-
+
+ Secured Extensibility
The flexibility of vibe-coded tools on secured foundations.
-
+
+ Modern Stack
React, TypeScript. Your team already knows how to extend Twenty. No proprietary languages, no gatekeeping.
-
-
+
+ No Lock-In
Open-source core, self-hostable, export your data anytime.
diff --git a/packages/twenty-docs/getting-started/key-features.mdx b/packages/twenty-docs/getting-started/key-features.mdx
index 214c4ff38a..462ad9e94e 100644
--- a/packages/twenty-docs/getting-started/key-features.mdx
+++ b/packages/twenty-docs/getting-started/key-features.mdx
@@ -4,84 +4,67 @@ description: A tour of everything Twenty can do — from custom data models to A
icon: "star"
---
+import { CardTitle } from "/snippets/card-title.mdx"
+
Twenty is a full-featured CRM platform. Here's what you can build with it.
-## Custom Data Model
+
+
+ Custom Data Model
+ Define the exact data structure your business needs.
+
Create custom objects, add custom fields with 20+ field types, and build relationships between any objects.
+
-Define the exact data structure your business needs. Create custom objects (beyond the standard Companies, People, and Opportunities), add custom fields with 20+ field types, and build relationships between any objects.
+
+ Views & Pipelines
+ Switch between table views, kanban boards, and calendar views.
+
Filter with AND/OR logic, sort by multiple fields, group records, and save custom views.
+
-
- Objects, fields, relations — fully customizable to your business.
-
+
+ Workflows & Automation
+ Automate any business process without writing code.
+
Trigger workflows on record changes, schedules, manual actions, or incoming webhooks.
+
-## Views & Pipelines
+
+ Calendar & Email Sync
+ Connect your Google Workspace or Microsoft 365 account.
+
Emails and calendar events automatically appear on the relevant CRM records.
+
-See your data the way you want. Switch between table views, kanban boards, and calendar views. Filter with AND/OR logic, sort by multiple fields, group records, and save custom views for your team.
+
+ AI
+ AI agents that work autonomously within your CRM — answering questions, enriching records, and executing multi-step tasks within your permission model.
+
-
- Table, kanban, calendar — all with powerful filtering and sorting.
-
+
+ Dashboards & Reporting
+ Build custom dashboards with real-time widgets.
+
Track pipeline metrics, team performance, and business KPIs with configurable charts and filters.
+
-## Workflows & Automation
+
+ Permissions & Access Control
+ Role-based access control at every level — objects, fields, and individual records.
+
Configure SSO with SAML or OIDC. Audit logs track who did what.
+
-Automate any business process without writing code. Trigger workflows on record changes, schedules, manual actions, or incoming webhooks. Chain together actions like creating records, sending emails, calling APIs, running custom JavaScript, and branching with conditions.
+
+ API & Extensibility
+ A developer-first API that adapts to your custom data model.
+
Both GraphQL and REST endpoints, with auto-generated documentation per workspace.
+
-
- Triggers, actions, branches, and integrations — all visual.
-
+
+ Data Import & Export
+ Import data from CSV files or via API.
+
Field mapping, duplicate detection, and error handling built in. Export your data anytime — no lock-in.
+
-## Calendar & Email Sync
-
-Connect your Google Workspace or Microsoft 365 account. Emails and calendar events automatically appear on the relevant CRM records. Send emails directly from Twenty and track all communication history.
-
-
- Sync mailboxes, track activity, send from Twenty.
-
-
-## AI
-
-Twenty integrates AI agents that can work autonomously within your CRM — answering questions about your data, enriching records, and executing multi-step tasks. AI works within your permission model so it only accesses what it should.
-
-
- AI chatbot, autonomous agents, and smart workflows.
-
-
-## Dashboards & Reporting
-
-Build custom dashboards with real-time widgets. Track pipeline metrics, team performance, and business KPIs. Configure chart types, date ranges, and filters to get the exact view you need.
-
-
- Widgets, charts, and real-time analytics.
-
-
-## Permissions & Access Control
-
-Role-based access control at every level — objects, fields, and individual records. Configure SSO with SAML or OIDC. Audit logs track who did what.
-
-
- Roles, SSO, object/field/row-level security.
-
-
-## API & Extensibility
-
-A developer-first API that adapts to your custom data model. Both GraphQL and REST endpoints, with auto-generated documentation per workspace. Build custom apps, connect via webhooks, or use Zapier.
-
-
- GraphQL, REST, webhooks, and custom apps.
-
-
-## Data Import & Export
-
-Import data from CSV files or via API. Field mapping, duplicate detection, and error handling built in. Export your data anytime — no lock-in.
-
-
- CSV import, API import, and migration from other CRMs.
-
-
-## Self-Hosting
-
-Run Twenty on your own infrastructure with a single Docker Compose command. Full control over your data, updates on your schedule, and no per-seat cloud fees.
-
-
- Docker Compose, configuration, and upgrade guides.
-
+
+ Self-Hosting
+ Run Twenty on your own infrastructure with a single Docker Compose command.
+
Full control over your data, updates on your schedule.
+
+
diff --git a/packages/twenty-docs/getting-started/quickstart.mdx b/packages/twenty-docs/getting-started/quickstart.mdx
index f6211e030f..8fa986a4e2 100644
--- a/packages/twenty-docs/getting-started/quickstart.mdx
+++ b/packages/twenty-docs/getting-started/quickstart.mdx
@@ -20,7 +20,9 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
-
+
+
+
## Configure your workspace
@@ -32,7 +34,7 @@ Once you're in, three steps to make Twenty yours:
Go to **Settings → Accounts** and connect your Google or Microsoft account. Twenty will import your emails and calendar events, and auto-create contacts from interactions. Using another provider? You can add mailboxes via SMTP or calendars via CalDAV from the same page.
Start here — connecting a mailbox gives your team immediate value with real data before you customize anything else.
-
+
### 2. Shape your data model
Go to **Settings → Data Model** to create custom objects and fields. A few things to know:
@@ -42,12 +44,14 @@ Go to **Settings → Data Model** to create custom objects and fields. A few thi
- You can deactivate standard fields/objects you don't need, and hide fields from views without deleting them.
[Data Model reference →](/user-guide/data-model/overview)
+
### 3. Import your data
Use the Command Menu (`Cmd+K` / `Ctrl+K`) to import People, Companies, Opportunities, or any custom object via CSV. Download the sample file first to see the expected format. Limit files to 10k records and deduplicate emails/domains before importing.
[Data Migration guide →](/user-guide/data-migration/overview)
+
## Next steps
diff --git a/packages/twenty-docs/snippets/vimeo-embed.mdx b/packages/twenty-docs/snippets/vimeo-embed.mdx
index edde55f3d4..9f2ba35a12 100644
--- a/packages/twenty-docs/snippets/vimeo-embed.mdx
+++ b/packages/twenty-docs/snippets/vimeo-embed.mdx
@@ -1,5 +1,5 @@
export const VimeoEmbed = ({ videoId, title = 'Video' }) => (
-