Sub-Form Selector


Launches a Sub Form from the Master Form. Sub Forms are most commonly used to capture several records of data in a single form.

NOTE: A Sub-Form must be created before a Sub-Form field can be added to a main form. 



Setting Description
Field Label The label displayed for the field. This is usually displayed at the top left corner above the field.
Field Key A Key used to reference the field in submission data. The key is also used to reference the field in rules and calculations.
Sub-Form The name of the Sub-Form that will be displayed.
Hint Text The text that is displayed if the field has no value set, e.g. "Please enter a value"
Rules A Rule or JavaScript snippet that allows you to perform actions on fields or sections within the form. The actions can include hide, show, enable, disable, showSection and hideSection. Rules are executed on field value changes and when the form is opened.

if ($field1$ > 23) { hide(); } else { show(); }

(Please see the Introduction to Rules Document for more information)
Hide Question Hides the Field Label.
Enabled If not set the field will be visible but cannot be edited or set to accept new input.
Hidden If enabled the field and all labels are not visible.
Allow Multiple Sub-Form Instances More than one value can be created and submitted in the form submission.
Exclude Report If checked, the field will be excluded from HTML and PDF reports and will also be excluded from Excel and CSV exports.
Color Choose a theme to change the background and font colors of the field cell as displayed in the apps.
Configure Display Mask A label generated from the field keys in your subform, allowing you to see contents of your choice from the subform when viewing a list of repeating subform instances. 


Result Data

Data Type Domain of Values Example JSON
Array of sub-form key value property Objects Any array that contains sub-form key value property Objects json{ "subform_1": [{ "alpha_1": "A new picture label"}, { "photo_1": "73e0d68e-a648-43e9-9299-518cb81e8359.jpg"}, { "alpha_1": "Another picture label"}, { "photo_1": "30e04c9a-ffb1-4e57-a855-b8c3d9bb454e.jpg"}]}
Have more questions? Submit a request