---
title: "How to Add a Field to a Table?"
description: "Add a new field in the table editor or quickly from the records view — with a semantic type."
---

# How to Add a Field to a Table?

A new field expands your Custom Data table structure. In v2 you can use the full **Custom Data model editor** or the quick path from the records table via **Add field**.

## When Needed

- You need to store additional information in table rows.
- You want a field type such as email, link, operator, or tag.
- You need a new column quickly without opening every editor tab.

## What's Important to Know

- A **field** is a column with a data type and label; the technical key is generated automatically (or set in advanced mode).
- The **semantic type** (text, number, email, table link, operator, etc.) drives validation and display.
- After you save the structure, existing rows get an empty value in the new field unless you set a **Default value**.
- Structural changes may show **Review changes before save**.

## Prerequisites

- [x] You opened **Menu → Custom Data**.
- [x] The table already exists.
- [x] You know the type and label for the new field.

## Step-by-Step (full editor)

1. In **Custom Data tables**, select the table → **Edit**.
2. On the **Fields** tab, click **Add field**.
3. Choose **Type** and enter **Label**.
4. Optionally expand the field card:
   - **Default value**, **Required**, **Unique values**, **View only**.
   - For links — **Link to table**; for platform directories — a system type (operator, subject, tag, etc.).
5. On **Field display**, enable **Table** and/or **Card** if the column should be visible immediately.
6. Click **Save**. Confirm **Review changes before save** if it appears.

## Quick add from records view

1. Open the table from **Tables**.
2. In the toolbar, click **Add field**.
3. In the **Add field** dialog, choose **Field type**, **Label**, and optionally **Default value**.
4. For advanced settings, click **Open full editor**.
5. Confirm — the field appears in the table; existing rows will have empty values in the new column.

## What Happens Next

The field is part of the table structure. New and existing rows can be filled in the table or record card.

## How to Verify

- The field appears on the **Fields** tab in the editor.
- The column shows in the records table (if **Table** is enabled).
- A test row saves without validation errors.

## Related Materials

- [Configure field type](/en/customdata/how-to/configure-field-type.md)
- [Configure system field types](/en/customdata/how-to/configure-system-field-types.md)
- [Edit a table](/en/customdata/how-to/edit-model.md)
- [Semantic field types reference](/en/customdata/reference/semantic-field-types-reference.md)