Skip to content

Instance · Forms

Settings

Last updated 1 November 2026

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.
Primary Button Text Color Input Field or Color Picker No The text color of the 'Next' and 'Submit' buttons. 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 color's corresponding hex code.
Primary Button Background Color Input Field or Color Picker No The background color for the 'Submit' and 'Next' buttons. Field behavior is similar to the 'Primary Button Text Color' field.
Secondary Button Text Color Input Field or Color Picker No The text color for the 'Back' button. Field behavior is similar to the 'Primary Button Text Color' field.
Secondary Button Border Color Input Field or Color Picker No The border color for the 'Back' button. Field behavior is similar to the 'Primary Button Text Color' field.
Submit Button Label Input Field No The label for the 'Submit' button.
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.
Error Message Code Editor No Message displayed if form submission fails. The message is auto-generated in the form code's alert box section.
<ins-alert-box type='error' class='api-error' close-icon='icon-close-1' hidden>
  <div>{Error Message}</div>
</ins-alert-box>
.

Note

Error messages are only displayed when form submission fails after passing field validation rules.

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 once the form is 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.