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. System types — Configure system field types.
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 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 |
| 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 |