Form Guard - Advanced Settings

Timeout

This setting defines the maximum time (in seconds) before validation times out. By default, if validation exceeds the timeout limit, the input value is considered acceptable, and form submission is not blocked. (Default: 10 seconds)

It is recommended to keep this setting at its default value, as increasing the timeout may negatively impact the user experience.

Mode

This setting controls how and when the Guard triggers validation for form fields.

• AJAX (Default): Validation is triggered when a user finishes interacting with a form field and moves focus away from it. This provides real-time feedback and is generally recommended for a smoother user experience.
• FormSubmit: Validation is triggered only when the user clicks the submit button. This mode validates all relevant fields at once, just before form submission.

Unless you have a specific reason to validate only on submission, it's recommended to keep this setting on AJAX for immediate validation feedback.

Submit Button Selector

The Clearout Form Guard is designed to automatically detect the submit button within your form. In most cases, no manual configuration is required.

However, if the Guard is unable to locate the submit button—due to non-standard markup or dynamic form rendering—you can manually specify the submit button by providing a valid jQuery selector in this field.

Use this option only when the automatic detection fails, ensuring that the Guard can correctly bind validation behavior to the form submission process.

On Ready Callback (optional)

This option allows you to define a custom JavaScript function that runs once Clearout's Form Guard has fully loaded on your page.

You can use this to execute custom JavaScript or CSS as soon as the Form Guard is initialized, enabling additional customization or functionality tailored to your needs.

                    
                      on_ready: function() {
                        // Your custom initialization code here
                        console.log('Clearout widget is ready!');

                        // Add custom styling or functionality
                        window.clearout.$('.my-form-field').addClass('some-custom-class');
                      }
                    
                  

Trigger Form Discovery on Event

Specifies when the Form Guard should attempt to discover forms on the page, based on a defined event.

This is particularly useful for platforms like the New HubSpot Forms, where forms are dynamically loaded and an event is emitted once they are ready

Limit Usage (optional)

This option allows you to set usage limits for your Form Guard, ensuring that validations do not exceed a specified threshold per IP or globally. This helps prevent excessive usage and protects your validation credits from being misused on pages where validations are enabled.

• Per IP: Defines the maximum number of validations allowed per individual IP address.
• Globally: Sets a usage limit for validations across the entire Form Guard.

Add Form URLs (optional)

This option lets you restrict validations to specific URLs, ensuring that your Guard runs validations only on approved pages.

You can also use wildcard characters (*) to define patterns instead of listing individual URLs. Pattern Examples & Interpretation:

• https://*.clearout.io/* → Allows access to any URLs and subdomains within Clearout.io.
• https://clearout.io/forms/* → Restricts access to URLs under /forms/ only.
• https://clearout.io/*/forms → Grants access to any URL ending with /forms, regardless of its position in the path.

Google Recaptcha v3 (optional)

This option allows you to enable Google reCAPTCHA v3 (invisible) for your Form Guard. It is recommended to enable this option if you are using a form provider that does not support reCAPTCHA. and additionally it safeguards your Form Guard from abuse.

You can find more information about Google reCAPTCHA v3 and how generate and site key and secret key fromhere.

The reCAPTCHA threshold is the minimum score required for a interaction to be considered human-like. The default threshold is 0.5, but you can change it to a value between 0.2 and 0.8. The higher the threshold, the more stricter the reCAPTCHA check is.