Customisation

How to Create and Edit Dynamic Forms (Entity Types & Fields)

Build custom forms — called entity types — to capture any information your organisation needs, from incident reports to vehicle checks.

Teiro lets you build custom forms — called entity types — to capture any kind of information your organisation needs to track. Whether that's an incident report, a coffee break log, a vehicle check, or a site induction, you can define exactly what fields appear and who can fill them in.

What is an entity type?

An entity type is a custom form template. Once you create one, your team can submit records based on it — each submission is a single entity record. Think of the entity type as the blank form, and each record as a filled-in copy.

Examples of entity types organisations create in Teiro:

  • Incident Report
  • Coffee Break
  • Vehicle Pre-Start Check
  • Client Home Visit
  • Support Session Note

Creating a new entity type

  1. 1.From the main menu, go to Settings > Entity Types.
  2. 2.Select Add entity type.
  3. 3.Enter a Name for your form (e.g. "Incident Report").
  4. 4.Optionally add a Description to explain what this form is for.
  5. 5.Select Save to create the entity type.

Your new entity type will appear in the list. It has no fields yet — you'll add those next.

The Entity Types list in Settings, with the Add entity type button in the top-right corner
The Entity Types list in Settings, with the Add entity type button in the top-right corner

Adding fields to your form

Fields are the individual questions or data points on your form. Teiro supports several field types to suit different kinds of information.

The entity type edit screen showing the field list and the Add field button
The entity type edit screen showing the field list and the Add field button

To add a field:

  1. 1.Open your entity type from the list.
  2. 2.Select Add field.
  3. 3.Choose a field type (see the list below).
  4. 4.Enter a Label — the question or prompt your team will see (e.g. "What happened?").
  5. 5.The Field key is set automatically from the label. You can edit it, but it must be unique and contain no spaces.
  6. 6.Mark the field as Required if a record cannot be submitted without it.
  7. 7.Select Save field.

Field types

Field typeUse it when you need to capture...
TextA short written answer (name, location, brief note)
Long textA detailed written response or description
NumberA numeric value (duration in minutes, quantity, rating)
DateA calendar date
DropdownOne option from a defined list (e.g. severity: Low / Medium / High)
CheckboxA yes/no or true/false value
Linked recordA reference to another record in Teiro (e.g. link to a client)
File uploadA photo, PDF, or other attachment

Organising fields with sections

Sections are collapsible groupings you can add to longer forms. For example, an Incident Report might have sections for "Incident Details", "Persons Involved", and "Follow-up Actions".

The entity type editor showing two named sections, each with fields grouped underneath
The entity type editor showing two named sections, each with fields grouped underneath

To add a section:

  1. 1.Open the entity type.
  2. 2.Select Add section.
  3. 3.Enter a Section name.
  4. 4.Drag fields into the section, or add new fields directly within it.

What "required" means

Marking a field as Required means a record cannot be submitted without completing it. Use required fields for information that is always essential — for example, the date and location of an incident.

Tips

  • Keep forms short. Staff complete forms faster and more accurately with fewer fields.
  • Test before rolling out. Create a test record yourself before asking your team to use a new form.
  • Field keys are used in exports. The field key becomes the column header in exported spreadsheets. Choose clear, readable keys.

Still have questions?

Our support team is here to help. Get in touch and we’ll usually respond within one business day.

Contact support