Settings

Last updated on May 27, 2025.

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. The message can be retrieved on the redirect to page using URL parameters.
Error Message Code Editor No Message displayed if form submission fails. The message is being auto-generated in the alert box section of the form code.
<ins-alert-box type="error" class="api-error" close-icon="icon-close-1" hidden>
  <div>{Error Message}</div>
</ins-alert-box>
.
Note

Error message will only pop up when form submission fails after passing field validation rules.

Guide on how to retreive success message using URL parameters

  • In Details tab, assign the value /thank-you?form=modules/ins_forms/example_form to the Redirect To.
  • Create your own redirect page in CMS -> Pages with the slug "/thank-you".
  • Add this code snippet at the top of the content:
    {%- graphql results, form: context.params.form -%}
    query ($form: String!) {
      items: admin_forms(
        filter: {
          name: {
            value: $form
          }
        }
      ) {
        results {
          success_message: flash_notice
        }
      }
    }
    {%- endgraphql -%}
    {%- assign success_message = form.items.results[0].success_message -%}
    
  • You can now use the variable {{ success_message }}, which contains the value from the success message field, throughout the page.
    {Code Snippet}
    ...
    <h2>{{ success_message }}</h2>
    

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.
Have a suggestion for this page?

Didn't quite find what you are looking for or have feedback on how we can make the content better then we would love to hear from you. Please provide us feedback and we will get back to you shortly.