Structured & Media Fields

Six field types storing a value with more shape than a string or a number: nested data, lists, colours, source code, coordinates, and scannable codes. All share the base field properties.

Type	Stores
json	Structured JSON data.
array	A list of values.
color	A hex colour value.
code	Source code with syntax highlighting.
geolocation	Latitude/longitude coordinates.
barcode	A barcode value (media category).

For the derived and interactive types — formula, count, autonumber, button — see Computed & Action Fields.

json

Stores structured JSON data.

Property	Description
schema	Optional object, accepted and kept.

- { id: 5, name: metadata, type: json, required: false }

array

Stores a list of values.

Property	Description
itemType	Data type of array elements (e.g. string).
maxItems	Maximum number of elements (integer ≥ 1).

- { id: 6, name: tags, type: array, itemType: string, maxItems: 10 }

maxItems is enforced; itemType is an unconstrained string, so it documents intent rather than restricting what may be stored.

color

Stores a colour in hexadecimal format, rendered with a colour picker.

Property	Description
default	Default colour as a 6-digit hex value with a leading #.

- { id: 7, name: brand_color, type: color, required: true, default: '#3B82F6' }

This is the one field on this page with a real format check: default must match # followed by exactly six hex digits. Three-digit shorthand (#3BF) and named colours (red) are rejected at config decode.

code

Stores source code as plain text, edited with syntax highlighting (CodeMirror 6).

Property	Description
language	Required. Language for highlighting (e.g. javascript, typescript, yaml, json, python, sql).
lineNumbers	Boolean. Show line numbers.
readOnly	Boolean. Make the editor read-only.
minLines	Minimum visible lines (integer ≥ 1).
maxLines	Maximum visible lines before scrolling (integer ≥ 1).
tabSize	Tab size in spaces. Integer from 1 to 8.

- { id: 8, name: snippet, type: code, language: typescript, lineNumbers: true, tabSize: 2 }

language is required but unconstrained — the listed values are the ones with highlighting support, and an unknown or empty string still passes validation. tabSize has no schema default; the editor falls back to 2 when the field omits it.

geolocation

Stores geographic coordinates (latitude and longitude) for location-based features. It takes no type-specific properties beyond the base field properties.

- { id: 9, name: office_location, type: geolocation, required: true }

barcode

Stores a barcode value for product identification and inventory. It belongs to the media category alongside the attachment fields, and is documented here with the other specialised value fields.

Property	Description
format	Barcode format (e.g. EAN-13, CODE128).

- { id: 10, name: product_barcode, type: barcode, required: true, format: EAN-13 }

format is an unconstrained string: it records which symbology the value uses, and nothing checks the value against it.

Related Pages

• Computed & Action Fields — formula, count, autonumber, button.
• Attachment Fields — the other two members of the media category.
• Field Types Overview — every field type by category.
• Tables Overview — the base properties every field shares.
• Table Validation — enforcing shape where the field schema does not.