Form Settings
Last updated on August 01, 2024.
Use the form in this tab to configure the settings for the form you are creating. The form is divided into the following sections:
- Form Buttons
- Alert Messages
- Callback Action
- Async Callback Action
Form Buttons
This section allows you to configure the behavior and properties of your form buttons.
| Input Label | Type | Required | Description |
| Button Alignment |
Radio Group |
No |
The alignment of the buttons in your form. Options include the following:
- Left: Aligns buttons to the left of the page.
- Center: Aligns buttons to the center of the page.
- Right: Aligns buttons to the right of the page.
- Space Between: Splits the alignment of two buttons sharing a row to make one left-aligned and the other right-aligned. This option's most common use case is the 'NEXT' and 'BACK' buttons in between form steps.
|
| Button Color |
Input Field or Color Picker |
No |
The text color of the form button. If you provide a hex code, the color picker displays a color that previews the corresponding hex code. Conversely, if you use the color picker, the field displays the corresponding hex code of the color. |
| Button Background Color |
Input Field or Color Picker |
No |
The background color of the form button. Similar to the 'Button Color' fields, if you provide a hex code, the color picker displays a color that previews the corresponding hex code. Conversely, if you use the color picker, the input field displays the corresponding hex code of the color. |
| Submit Button Label |
Input Field |
No |
The label displayed on the 'Submit' button. For example, you may want to use labels such as 'FINISH' or 'DONE.' |
| Show Button Icons |
Toggle |
No |
Use the toggle to show or hide button icons. Enabling this option displays the icons , , and on the 'NEXT,' 'BACK,' and 'SUBMIT' buttons, respectively. |
| Submit Button Icon |
Input Field |
No |
The icon displayed to the left of the 'Submit' button label. Please refer to the Insites Font Icons documentation for a list of all available icons. |
Alert Messages
This section enables you to configure alert messages used by the form.
| Input Label | Type | Required | Description |
| Success Message |
Code Editor |
No |
Message displayed after the form has been successfully processed. The message can be accessed using Liquid . |
| Error Message |
Code Editor |
No |
Message displayed if form submission fails or is invalidated. The message can be accessed using Liquid . |
Callback Action
This section lets you add synchronously executed code once the form is successfully validated.
| Input Label | Type | Required | Description |
| Callback Action |
Code Editor |
No |
Liquid Template code executed synchronously as soon as the form is successfully validated. Note that using synchronously executed code may slow down the response to the user. |
Async Callback Action
This section lets you add asynchronously executed code on form validation.
| Input Label | Type | Required | Description |
|---|
| Priority |
Dropdown Field |
No |
The execution priority of the callback action when it is executed at the same time as other callbacks. Options include the following:
- Default (will end the process after 5 minutes)
- High (will end the process after a minute)
- Low (will end the process after 4 hours)
|
| Delay |
Number Field |
No |
The number of minutes before the callback action is executed after successful form validation. |
| Max Attempts |
Number Field |
No |
The number of times the callback action is executed in case of an error. The default value is 1. |
| Async Action |
Code Editor |
No |
Asynchronous action that is executed to run in the background as soon as the form is successfully validated. Asynchronous code execution does not impact user responses and, as such, can be configured to run for extended durations. |
