Item Field Types
Last updated
A list of the field types that can be set on an item’s fields. A field is an input for an item’s value. The field type determines the data that can be entered in that field. When you create a field on the Schema screen, you choose one of the following field types. For the field types available for groups and metadata, see Group and Metadata.
| Field type | What it holds |
|---|---|
| Text | A single line of text |
| TextArea | Multi-line text |
| Markdown text | Text that supports Markdown syntax |
| Int | An integer |
| Float | A number that can include decimals |
| Boolean | A value of true or false |
| Option | A selection from predefined options |
| Date | A date |
| URL | An http or https URL |
| Asset | An uploaded file |
| Reference | A reference to an item in a selected model |
| Group | A predefined group |
| Geometry Object | Geometry in GeoJSON format |
| Geometry Editor | Geometry drawn on a map |
A field that holds a single line of text. Used for short strings such as headings and titles.
TextArea
Section titled “TextArea”A field that holds multi-line text. Used for longer text with paragraphs.
Markdown text
Section titled “Markdown text”A field that holds text supporting Markdown syntax. Used for text that includes formatting such as headings and emphasis.
A field that holds an integer. Stores a number that does not include decimals.
A field for numbers that may include a fraction. It accepts both values with a fractional part and whole numbers.
Boolean
Section titled “Boolean”A field that holds either true or false. Entered by turning a switch on or off.
Option
Section titled “Option”A field where you choose one of the predefined options. If you set “Support multiple values” in Field Attributes, you can choose more than one. Options are registered when the field is created, and at least one option is required. Options cannot have duplicate values.
A field that holds a date. Stores a date value.
A field that holds a URL. Accepts URLs beginning with http:// or https://. The host must be either a domain name with a top-level domain (such as .com) or a public IP address. localhost and private IP addresses (such as 192.168.x.x or 127.x.x.x) are not accepted.
A field that links an uploaded file. Used to store files such as images and documents.
Reference
Section titled “Reference”A field that references an item in a selected model. Use it to relate one model to another. When you create the field, you choose one model to reference and one of the two directions below. For the model to reference, you can choose either a different model or the model that holds this field.
- One-way reference: One item references another item.
- Two-way reference: Two items reference each other.
The model to reference and the reference direction can only be set when the field is created. They cannot be changed afterwards. To change them, delete the field and create it again.
A field that holds a predefined group. Reuses a group of multiple fields, bundled together, as a single field.
Geometry Object
Section titled “Geometry Object”A field for entering geometry in GeoJSON format. The entered content can be previewed. The supported types are chosen when the field is created, from the following seven. You can select more than one.
- Point
- Linestring
- Polygon
- GeometryCollection
- MultiPoint
- MultiLinestring
- MultiPolygon
Geometry Editor
Section titled “Geometry Editor”A field for entering geometry by drawing on a map. The supported type is chosen when the field is created, one from the following four.
- Point
- Linestring
- Polygon
- Any: Point, Linestring, and Polygon (with Any, a polygon can also be drawn as a circle or a rectangle)