Using InForm configurable attributes
Who is this article for?Administrators who want to learn to use configurable attributes.
Administrator permissions are required.
Form fields can be highly customised to suit specific requirements using configurable attributes. This guide provides a comprehensive overview of the various configurable attributes available for form fields and how they can be used to enhance the user experience.
1. Configurable attributes in form fields
Configurable attributes are used to customise each form field to meet specific requirements. Some attributes are unique to individual fields, while others are shared across multiple form fields.
To configure form field attributes:
- Select the required form field from the Form Edit page.
- Use the edit field screen on the left to configure the attributes as needed (see definitions below).
1.1. Configurable attribute definitions
| Configurable Attribute | Form Field | Definition |
|---|---|---|
| Reference ID |
Multiple |
Used to track which column corresponds to which field, especially for repeated fields or fields with similar labels. The reference ID will display in brackets on the form records page and Excel reports. |
| Details | Multiple |
Provide a label/title for the field and additional instructions for respondents if required. |
| Required | Multiple |
Select if the field is mandatory. Respondents can save progress, but the form status will remain In Progress until all mandatory fields are completed. |
| Conditionally Display | Checkbox, Radio, Dropdown |
These field types can be used to conditionally display a follow-up field, e.g., an Other text field that appears only if Other is selected. |
| Add Photo/Add Action |
Text, Paragraph, Info
|
Allows respondents to add a photo or action directly below the field. Only images can be uploaded. |
| Include Scoring | Dropdown, Radio Button |
Select if scoring should be applied to the question. |
| Options | Dropdown, Radio Button, Checkbox |
Populate the response options to be displayed. |
| Editing Tools | Info |
Information boxes allow for simple editing of text, as well as the insertion of tables and hyperlinks. |
| Display Full Width | Table |
Selecting this option will display the table title above the table, which is recommended for mobile use. |
| Header Label/Background Color | Table Fields |
Adjust the text and background color for fields within tables. |
| Default to Current Date/Time | Date, Time |
Automatically display the current date or time, which respondents can adjust if needed. |
| Number of Options per Row | Radio Button |
Adjust the number of radio button options to display per row. |
| Populate From | Text, Paragraph |
Auto-populate the field with data from a selected data source. |
| Data Source | Data Source |
Select the data source the form will gather data from. |
| Display | Data Source |
Select which field from the data source to display. |
| Apply a Filter? | Data Source |
Apply filters to the data source displayed. |
| Whole Numbers Only? | Number | Only allow whole numbers (no decimals) for number fields. |
| Minimum/Maximum | Number |
Set minimum and maximum values for number fields. |
| Display Column Total | Number, Table | Sum up the number fields in a table column and display the total. |
| Total | Number, Table |
Sum up or multiply the number fields in a table row. |
| Additional Fields | - | The ability to add an action and/or attachment will automatically appear once the form is published, in the "Additional" section at the bottom of the form. |