Skip to content

Field Types

Every entity field has a type, which determines how it's stored, displayed, and edited. Some types are available right away in the entity creation wizard (see Entities Overview); the rest are added later, in the full schema editor, on the form layout tab.

Basic types

TypeDescriptionUsed for
TextSingle-line textNames, short labels
TextareaMultiline textDescriptions, comments, long-form text
IntegerWhole numberQuantities, sequence numbers
FloatFloating-point numberAmounts, measurements
BooleanYes/no (toggle)Flags, indicators
DateDate without timeDeadlines, birthdays
Date & TimeDate and timeDeadlines, event timestamps
EmailEmail address with basic format validationContact information

Types for specific value formats

TypeDescriptionUsed for
Phone (📞)Phone numberContact information
URL (🔗)LinkExternal resources, documentation
Telegram (✈️)Telegram contact/linkContact information
WhatsApp (💬)WhatsApp contactContact information

For the Phone and WhatsApp types, you can additionally configure the number format/mask in the field editor.

Value lists and statuses

TypeDescriptionUsed for
Value ListA field with a fixed set of options defined by the administrator (value + display name)Priority, request type, and any enumerable values
State ModelThe record's state model — a status with a limited set of allowed transitionsRecord lifecycle. See State Models for details
CategoryA reference to a node in a tree-structured catalog (category catalog)Categories, sections, hierarchical classifiers — see Categorization

An entity can have only one State Model field.

Relations to other entities and users

TypeDescriptionUsed for
Model ListA reference to one or more records of another entity (which records can be selected may depend on the value of another field, and already-linked records can be excluded)For example, a "Responsible Department" field referencing the "Departments" entity
UserA reference to a system userRequester, assignee, approver
CompanyA reference to a company (with the option to restrict visibility scope)Multi-company scenarios, customers
Org UnitA reference to a department in the org structureLinking a record to a department/unit

Org Unit and User fields can be restricted to "internal only" and filtered by an employee's presence (current activity) status.

For relations between entities that need a bidirectional table with their own attributes (rather than just a reference in a field), a separate mechanism is used — see Relations.

Files and media

TypeDescriptionUsed for
FileOne or more files of any type (configurable via the "Allow multiple files" checkbox)Attachments, documents
ImageA single image or a gallery ("Allow multiple images" checkbox)Photos, screenshots
Point on MapA geographic point (coordinates)Site addresses, geolocation
Image MapAn image with marked points on itDiagrams, floor plans with records linked to points on the plan

Service and builder types

TypeDescriptionUsed for
Type ExtenderA record subtype — turns one entity into several variants, each with its own set of visible fields and (optionally) its own set of state model statusesFor example, a "Ticket" entity with "Incident" / "Change Request" subtypes

A subtype (Type Extender) doesn't duplicate the state model — all statuses are stored once in the entity's shared registry, and for each subtype the administrator simply marks which of the shared statuses and transitions are available to it. See State Models for details.

Catalogs (category references)

If an entity is created as a tree-structured catalog (category catalog), only a reduced set of simple types is available for it: Text, Textarea, Integer, Float, Boolean, Email, Date, Date & Time, Value List — no relations, media, or service types. This is because catalogs don't have a record card, history, or chat — they're just a tree of labeled nodes.

System fields

In addition to custom fields, every record has system fields that aren't editable in the builder but are visible in the list and card: id, creation date, last modified date, creator, and last editor.

Orbita ITSM documentation