# Semantic field types reference

A field’s semantic type in **Custom Data** defines storage format, validation, and display in the records table and card. Types are grouped in the editor; technical keys (`text`, `integer`, `association`, etc.) are set when you pick a type in the UI.

> To configure types in the editor, see [Configure field type](../how-to/configure-field-type.md). System types — [Configure system field types](../how-to/configure-system-field-types.md).

---

## Basic

| UI type | Purpose | UI hint |
|---------|---------|---------|
| **Text** | Short STRING | ~255 chars; names, codes |
| **Long text** | Multi-line TEXT | Comments, descriptions |
| **Number** | INTEGER | Counts, IDs, ratings |
| **Big number** | BIGINT | Large integers |
| **Decimal** | FLOAT | Decimals, amounts |
| **Checkbox** | BOOLEAN | Yes / no |
| **Date** | DATE without time | Event date |
| **Date & time** | DATE + time picker | Timestamp |
| **Time** | HH:mm or HH:mm:ss mask | Hours, slots |
| **Color** | Hex + swatch in table | Color labels |
| **JSON** | JSON object | Structured data; truncated in table |

---

## Contacts & links

| UI type | Purpose | UI hint |
|---------|---------|---------|
| **Email** | Email validation | Clickable mailto |
| **Phone** | tel input | Phone mask |
| **Link** | URL validation | **Open link** in table |
| **Coordinate** | Lat/long STRING | OpenStreetMap; format "50.4501,30.5234" |

---

## Lists & relations

| UI type | Purpose | UI hint |
|---------|---------|---------|
| **List** | Static SELECT options | Fixed value list |
| **API list** | Options from ActionJail | Action + **label field**; [how-to](../how-to/configure-select-api-field.md) |
| **Table relation** | FK to another Custom Data table | **Table**, **Label field**, **Value field (FK)** |

Many-to-many links in v2 are read-only in the editor (**Many-to-many relation (read-only)**).

---

## Media

| UI type | Purpose | UI hint |
|---------|---------|---------|
| **File** | File upload on record | **Upload file** |
| **Image (URL)** | URL with preview | **Open image preview** |

---

## System

Links to platform entities; the table stores an **ID**.

| UI type | Directory source |
|---------|------------------|
| **User** | Users from Settings |
| **Skill group** | OP settings |
| **Subject** | Subjects from OP settings |
| **Chat status** | Chat statuses from OP settings |
| **Tag** | Tags from OP settings |
| **Priority** | Ticket priorities (Tickets settings) |

---

## Common field options (all types)

| UI option | Description |
|-----------|-------------|
| **Label** | Column / card field name |
| **Technical key** | API and process key; editable until table save |
| **Required** | Must be filled on save |
| **Unique values** | No duplicates |
| **View only in table** | No inline grid edit |
| **Hide column** / **Table** on display tab | Visibility in records table |
| **Card** | Field in record side panel |

---

## Related material

- [Configure field type](../how-to/configure-field-type.md)
- [Configure system field types](../how-to/configure-system-field-types.md)
- [Configure field display](../how-to/configure-field-display.md)
- [Create an association between tables](../how-to/create-association-between-tables.md)
- [Advanced model options](./advanced-model-options-reference.md)