Custom Data Field JSON Configuration Reference

Short reference: which keys in columns_json and front_json are controlled from the Custom Data model editor, and which only via the JSON toggle or the advanced reference.

Configuration levels

LevelUI locationStored as
Field typeFields tab → field cardtype, semantics (system_ref, association, options, …)
Data & validationFields → card detailsdefault, unique, rules, non_editable
DisplayField displaywidth, align, hidden_in_table, modal_entity, columns_chooser, table_stylization, modal_entity_layout
AdvancedJSON or advanced referencehidden_all, hide_in_filter, highlight_rules, widgets (MAP, SLIDER, …)

Field card controls

ControlJSON keyPurpose
Default valuedefaultInitial value on record create
Requiredrules: ["required"]Field must be filled
Unique valuesuniqueUNIQUE index in DB
View onlynon_editableBlock inline edit in table
Validation rulesrulesemail, url, digits, json, …

Type-driven keys (system_ref, association) come from the selected Type, not separate card fields.

Field display tab

UI settingStorage
Field order (drag-and-drop)columns_chooser[].position
Table togglecolumns_json[key].hidden_in_table + columns_chooser[].active
Card togglemembership in front_json.modal_entity
Label / icon / color / editablefront_json.modal_entity[key].{label,icon,icon_color,editable}
Width / alignmentcolumns_json[key].{width,align}
Column totalcolumns_json[key].total_* + front_json.table_stylization.total_row
Row highlightingfront_json.table_stylization.colorize or highlight_rules
Record card groupsfront_json.modal_entity_layout
{
  "version": 1,
  "display": "accordion",
  "groups": [
    { "id": "main", "title": "Main", "fields": ["name", "status"] }
  ]
}
  • Fields with Card enabled but no group go to Other.
  • Without modal_entity_layout the record card is a flat list (backward compatible).

System types (system_ref)

{
  "type": "INTEGER",
  "label": "Assignee",
  "system_ref": "user"
}

Allowed values: user, skill_group, subject, chat_status, tag, priority. Stored as INTEGER id in DB.