Files
twenty/packages/twenty-docs/user-guide/data-model/how-tos/create-custom-fields.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 <github-actions@twenty.com>
Co-authored-by: Abdul Rahman <ar5438376@gmail.com>
Co-authored-by: Félix Malfait <felix.malfait@gmail.com>
2025-12-22 09:07:06 +01:00

72 lines
2.1 KiB
Plaintext

---
title: Create Custom Fields
description: Step-by-step guide to adding custom fields to any object.
---
Custom fields let you capture information specific to your business. Add them to any object—standard or custom.
## Steps
1. Go to **Settings → Data Model**
2. Select the object you want to add a field to
3. Click **+ Add Field**
4. Choose a **field type** (see [Fields](/user-guide/data-model/capabilities/fields) for all types)
5. Enter the **field name** and optional description
6. Configure field-specific settings (see below)
7. Click **Save**
**Quick method:** Click the **+** at the end of column headers in any table view → **Customize fields**.
## Show the Field in Views
New fields aren't automatically visible. To display:
1. Open the object's table view
2. Click **Options → Fields**
3. Click the **eye icon** next to your field to show it
4. Drag to reorder
## Configuration Options
### For Select / Multi-Select
1. Click **+ Add option** to create choices
2. Set a **default option** if desired
3. Drag to reorder options
<Note>
**Use API names for imports.** Enable **Advanced mode** in Settings to see API names. See [Field Mapping](/user-guide/data-migration/capabilities/field-mapping).
</Note>
### For Currency Fields
Set the **default currency** (USD, EUR, etc.) for new records.
### For Phone Fields
Set the **default country code** to pre-fill for new phone numbers.
### Making a Field Unique
Toggle **Unique** to prevent duplicate values across records.
<Note>
If duplicates exist (including in deleted records), you'll get an error. Clean up duplicates first.
</Note>
### Setting Default Values
For Select fields, you can choose which option is pre-selected for new records. For Checkbox fields, set whether it's checked or unchecked by default.
## Deactivating a Field
1. Go to **Settings → Data Model**
2. Find the field
3. Click **⋮ → Deactivate**
Data is preserved. You can reactivate or permanently delete later.
## Related
- [Fields](/user-guide/data-model/capabilities/fields) — all field types explained
- [Data Model FAQ](/user-guide/data-model/how-tos/data-model-faq) — common questions