Skip to main content

Item form controls

Build your item form with controls

Controls are the building blocks of your item form. They let users view and edit data on the item being created/edited.

When editing an item form, you can add controls via the Menu button (bottom-right).

Attribute controls

Add a control for each attribute that you want the user to view or edit (controls can be read-only). Depending on the attribute, there may be several control types to choose from. Select the one that best fits your needs.

Controls appear as a field on the item form. When the user selects it, they can enter a value directly, or select one from a picker.

A Date picker control as it appears on an item form

For Text attributes


Control typeAttribute typeDescriptionPreviewAlloy Mobile
Collection code pickerTextUser can pick a collection to store as text.As a Text input
Colour pickerTextUser can pick a colour to store as text (hex code).As a Text input
Design or interface pickerTextUser can pick a design or interface to store as text (Guc code).As a Text input
Icon code pickerTextUser can pick an Alloy icon to store as text (icon code).As a Text input
Mesh pickerTextUser can pick a Mesh item to store as text (Guc code).As a Text input
Multiline text inputTextUser can type text with line breaks into a large box.As a Text input
Text inputTextUser can type text into a single line field.

For other attributes


Control typeAttribute typeDescriptionPreviewAlloy Mobile
AQS editorAQSUser can build and submit a query with the AQS Builder.
CheckboxYes/NoUser can toggle the attribute between true and false.
Date pickerDateUser can pick a date with the calendar picker.
Date time pickerDate TimeUser can pick a date and time with the calendar picker.
File pickerLinkUser can pick a file stored in Alloy or upload one directly.
Geometry editorGeometryUser can set coordinates with the Geometry Editor.
Item pickerLinkUser can pick items from the attribute's lookup list with the item picker.
JSON pickerJsonUser can input JSON code.
JSON form editorJsonUser can input or choose values for each property defined by the attribute's schema.
Number inputNumberUser can type a number into the field.
Seasonal pickerSeasonalUser can pick a day of the year with the calendar picker.
Time pickerTimeUser can pick a time with the calendar picker.

Other controls

These controls are cosmetic and useful for structuring your item form:

  • Separator - break up your item form into sections.

  • Title - label the sections in your item form.

  • Labels - display different types of read-only data in your item form. Unlike attribute controls, their values aren't submitted when the form is saved. They can display a static value entered by you, the value of an attribute, or the output of a targeted expression.