Every field has an ID and a name. It can also have help text, a placeholder, a default value and a required flag.
| Type | Stored as | Validations |
|---|---|---|
| Short text | text | length, email or URL format, regex pattern |
| Long text | text | length, regex pattern |
| Integer | whole number | minimum, maximum |
| Decimal | number | minimum, maximum |
| Boolean | true or false | none |
| Date | YYYY-MM-DD | earliest and latest date |
| Date and time | ISO 8601 in UTC | earliest and latest date |
| Select | one of the options | value must be an option |
| Multi-select | list of options, no duplicates | minimum and maximum items |
| List of text | list of text values | minimum and maximum items, length of each |
| Media | link to an asset, or several | minimum and maximum items (many), required |
| Reference | link to an entry, or several | minimum and maximum items (many), required |
| Repeater | list of items made of sub-fields | minimum and maximum items, required |
Media and Reference
- One or many: choose whether the field holds one item or several. This setting locks once entries exist, because it changes how the value is stored.
- Accept only images (Media) and Accept only specified entry types (Reference) limit what editors can pick.
- Limit number of items is available when the field holds many.
- These fields have no default value.
Repeater
A Repeater groups sub-fields into items that editors can add, remove and reorder. Sub-fields appear indented under the Repeater in the schema editor. Repeaters go one level deep: a Repeater can't contain another Repeater. If a Repeater is required, it needs at least one item.
Show only when…
Any field can be shown only when a Boolean, Select or Multi-select field matches a value you choose. Each field can have one rule. Chains are allowed, and loops are rejected. A hidden field keeps its value and isn't validated. You can't remove a field, or change its type, while another field depends on it.