Skip to main content

Form Settings

Form-level settings control behavior that's not tied to any one field — the Submit button text, what happens after submission, how required fields are marked, and more. Open them from the Form Designer's SETTINGS tab (right panel when no field is selected).

Submit Button Text​

The text on the Submit button at the bottom of the form. Defaults to Submit. Pick anything that fits your call to action.

Examples:

Use CaseSuggested Text
Newsletter signupSubscribe
Lead captureGet the guide
BookingReserve my spot
Demo requestRequest a demo
OrderComplete order

The submit button is automatically styled with the form's button color (see Style & Design → Colors).

Success Message​

What the visitor sees on the Thank You screen after a successful submission. Defaults to Thank you for your submission!.

Examples:

  • You're in! Check your email for next steps.
  • Thanks — we'll be in touch within 24 hours.
  • Order received. Your confirmation will arrive shortly.

In conversational forms, this is overridden by the per-screen Thank You title if you've configured one. It's also overridden by an ending screen's title if conditions match.

Redirect URL after submit​

When set, the form redirects to this URL ~800ms after a successful submission. The success message renders briefly first, then the page navigates.

Examples:

  • https://yoursite.com/thank-you
  • https://yoursite.com/download/guide.pdf
  • https://calendly.com/yourteam/intro-call

Leave blank to stay on the success screen instead of redirecting.

The redirect uses window.location.href = redirectUrl so any URL is valid — same-origin or cross-origin.

Pass the lead ID forward

The form-submission API returns the new lead's ID. If you need it on the redirect page (e.g. a personalized thank-you), set up the redirect destination to read the visitor's lead from localStorage (the form caches votel_lead_id automatically) or pass it through via URL params on the destination side.

Required Field Indicator​

How required fields are visually marked.

ModeWhat It Shows
Asterisk (default)A red * after the label
(required) textThe literal text (required) after the label
NoneNothing — required fields look the same as optional ones

Each mode is a global form preference. Visitors still can't submit until required fields are filled regardless of which indicator you pick.

Show Progress Bar​

Toggle. When on, a thin progress bar renders at the top of the form card.

Form TypeProgress Calculation
Premium / Popup(filled input fields) / (total input fields) × 100 — updates as the visitor fills the form
Conversationalcurrent screen number / total screen count × 100 — updates as they advance

The progress bar is colored to match your form's Button Color (see Style & Design → Colors).

Default Label Position​

The fallback label layout for fields that don't have their own per-field Label Position set.

PositionBehavior
Top (default)Label above the input
LeftLabel fixed-width column on the left, input column on the right
HiddenLabel visually hidden but accessible to screen readers

Per-field Style → Label Position wins when set. This is just the default for unset fields. Useful for switching the entire form to a left-label layout in one click instead of changing each field individually.

Saving Settings​

Settings save when you click the header Save button (same as field changes). They persist as part of the form's settings JSONB column on the backend.

Worked Example: Set Up a Newsletter Form​

Goal: Configure a clean newsletter form that redirects to a thank-you page on success.

Steps:

  1. Open Form Designer → SETTINGS tab.
  2. Submit Button Text: Subscribe
  3. Success Message: You're in! Check your email for next steps.
  4. Redirect URL: https://yoursite.com/welcome
  5. Required Indicator: Asterisk
  6. Progress Bar: off (a 2-field form doesn't need it)
  7. Default Label Position: Top
  8. Save.

Visitors who fill in the form click Subscribe, see "You're in!" briefly, then land on https://yoursite.com/welcome.

Next Steps​