app.custom_field_definitions
TableRow level security on
Org-defined fields on built-in tables (Section 7.3 Workflow engine). Values live in custom_field_values with typed columns.
Primary key: id
| Column | Type | Nullable | Description |
|---|---|---|---|
| id | uuid | No | Primary key, UUID v7. |
| org_id | uuid | No | Owning org. A row never moves to another org.References app.organizations.id |
| target_table | text | No | Built-in table the field extends.References private.custom_field_targets.table_name |
| field_key | text | No | Lowercase key, unique per org and table. |
| label | text | No | Display label, the org's own text. |
| data_type | app.custom_data_type | No | Data type; decides the value column. |
| required | boolean | No | True when forms require a value. |
| filterable | boolean | No | True when views filter on the field; adds a partial index. |
| sort_order | integer | No | Position in forms. |
| created_at | timestamp with time zone | No | When the row was inserted. Set by the database. |
| created_by | uuid | Yes | Person who inserted the row, or null for a platform process. Set by the database.References app.people.id |
| updated_at | timestamp with time zone | No | When the row last changed. Set by the database. |
| updated_by | uuid | Yes | Person who last changed the row, or null for a platform process. Set by the database.References app.people.id |
| deleted_at | timestamp with time zone | Yes | Soft delete time. A row with deleted_at set is ignored by every access helper. |