Customization Settings

Customization Settings allow you to control how your form behaves after submission, including redirect URLs, query string parameters, and success/error handling.

Accessing Customization Settings

Navigate to any form, click "Settings" in the navigation menu, then select "Customization". You'll see customization options organized in cards.

Customization settings require appropriate permissions. Contact the form owner if you don't see these options.

Query String Parameters

Control whether form data is included in redirect URLs as query string parameters:

Enabled: Form field values are appended to redirect URLs
Disabled: Redirect URLs remain unchanged

When enabled, submitted form data is added to redirect URLs as query parameters. For example: ?name=John&[email protected]

Be careful with sensitive data in query strings, as they appear in browser history and server logs. Use this feature only for non-sensitive information.

Redirect URL

Set a default redirect URL for successful form submissions:

URL: The page users are redirected to after successful submission
Format: Full URL (e.g., https://example.com/thank-you)

The redirect URL is used when no success URL is specified or when using HTML form submission without REST mode.

Use a thank-you page that confirms the submission was received and provides next steps for users.

Success URL

Configure a custom success page for successful submissions:

URL: The page users are redirected to after successful submission
Takes Precedence: Overrides the default redirect URL if both are set

Success URLs are particularly useful when you want different success pages for different forms or when using REST API mode with custom handling.

Using Success URLs

When a form submission succeeds:

If successUrl is set, users are redirected there
If not set, the default redirectUrl is used
If neither is set, a default success page is shown

Success URLs can include query string parameters if that feature is enabled, allowing you to pass form data to the success page.

Error/Failed URL

Configure a custom error page for failed submissions:

URL: The page users are redirected to when submission fails
Error Handling: Provides a better user experience for errors

Error URLs help users understand when something went wrong and provide guidance on what to do next.

Create a user-friendly error page that explains what happened and suggests alternatives (e.g., try again, contact support).

Understanding URL Priority

When multiple URLs are configured, they follow this priority:

Success URL (if submission succeeds)
Error URL (if submission fails)
Redirect URL (fallback for success)
Default Pages (if none are configured)

Query string parameters are only added when that feature is enabled, regardless of which URL is used.

REST Mode vs HTML Mode

The behavior differs based on how you submit the form:

REST Mode (`mode=rest`)

Returns JSON response instead of redirecting
Success/error URLs are not used
You handle redirects in your JavaScript code

HTML Mode (default)

Browser redirects after submission
Success/error URLs are used automatically
Query string parameters are added if enabled

When using REST mode, you have full control over redirects in your JavaScript code. Success/error URLs are primarily for HTML form submissions.

Best Practices

Use Thank-You Pages: Always redirect to a thank-you page after successful submission
Handle Errors Gracefully: Provide clear error pages with helpful guidance
Avoid Sensitive Data in URLs: Don't include passwords or sensitive information in query strings
Test Redirects: Verify that all URLs work correctly before going live
Consider User Experience: Make sure redirects feel natural and don't confuse users

Test your customization settings thoroughly. Submit test forms and verify that redirects work as expected in different scenarios.

Example Use Cases

E-commerce Contact Form

Success URL: /contact/thank-you
Error URL: /contact/error
Query String: Disabled (no need to pass data)

Success URL: /newsletter/success?email={email}
Query String: Enabled (to show email on success page)

Support Request

Success URL: /support/thank-you
Error URL: /support/error
Query String: Disabled (sensitive information)

Next Steps

Configure General Settings: Set up form status, data retention, and webhooks
- Learn about General Settings →
Set Up Notifications: Configure email notifications for new submissions
- Learn about Notifications →
Review Integration: Ensure your form integration handles redirects correctly
- Learn about Setup →

Customization Settings

On this page