✅

registration

The registration sub-collection of an event document contains just a single document with it's key matching the event id. The document defines the fields collected and their layout in the registration form on the event landing page.

Example document and result

The registration form shown on the event landing page.
The registration document for the event.

Registration document properties

NameRequiredData typeDescription
layout
ArraySet the order of the form sections and fields within them.
fieldData
MapConfigure each field's name, type, hints and validation rules.
options
MapConfigure whether certain platform-wide sections are shown, for example the "Your profile" section which asks users their job title and organisation.

📐 Layout

The layout array contains an element for each section of the form, each with a title and list of fields.

Section element properties

NameRequiredData typeDescriptionExample
title
StringThe section title displayed in the form stepper.Screenshot from 2020-09-28 13-41-24.png
fields
ArrayA list of the field keys to be shown in this section.Screenshot from 2020-09-28 13-40-56.png
hint
StringA subtitle shown beneath the section title. Optional.Screenshot from 2020-09-28 13-41-28.png

🗃️ Field data

Each property in the fieldData map represents a form field which can be displayed in the registration form. The name of the property in the map is how the field is referenced in the fields array in each section element of layout.

Field object properties

NameRequiredData typeDescriptionExample
name
StringThe label which appears above the field.
type
StringThe type of data the field collects. text - A text field select - A dropdown selection field checkbox - A checkbox field photo - A file upload field which accepts JPEGs and PNGs address - Special type which creates multiple fields to collect address data email - Special type which creates a text field with email validation rules
hint
StringA hint which appears below the field.
conditions
Array

Some field types have additional properties.

Select field properties

NameRequiredData typeDescriptionExample
values
ArrayA list of values which the user can choose from in the dropdown.
other
BooleanWhether or not to add an "Other" option to the dropdown which will show a text field for typing a different response.