The Form widget is a single element: connect a collection, choose fields and labels, and let visitors submit — including image, video, and Media Gallery uploads. Split long forms into steps, show fields only when a condition is met, create a Wix contact, register a site member, and trigger Wix Automations. On Pro, you can collect payment on submit via Wix Checkout, cut spam with reCAPTCHA / honeypot / rate limits, and assign contact labels or member badges and groups.
Submissions land in your collection so you can display them later with Table or Repeater. With Update displays on this page, a list on the same page refreshes as soon as the submission succeeds — see Data refresh.
Video tutorial
Use case examples
- Contact form — Save inquiries to CMS and create (or update) a Wix contact; optionally assign CRM labels.
- Multi-step intake — Split long applications into pages with Next / Back; show extra questions only when a prior answer matches.
- Draft intake — Autosave keeps a member’s unfinished submission in the collection, or a visitor’s draft in this browser, until they submit.
- Member signup — Create a site member with login email and password on submit; optionally assign badges or add to groups.
- Spam-resistant intake — Spam & bot protection with reCAPTCHA, a honeypot field, and a submit rate limit (Pro).
- Paid registration — Collect a fee via Wix Checkout (Pro), then write order fields back to the submission.
- Live list — Form + Repeater on the same page; Update displays on this page shows the new item immediately.
Configure a Form
Build with AI: Open AI setup at the top of the panel and describe fields and submit copy — then refine in Manual. Details: AI setup.
- Add Form from Add → Elements → Installed Apps → CMS for Harmony.
- Select the widget → open Settings.
- In Content, connect a collection and choose fields.
- Optionally turn on Steps for a multi-page form.
- Configure Field setup (labels, input types, step assignment, Show only when, Hidden fields) and Submit, including optional Autosave.
- Optionally turn on Contacts, Members, Spam & bot protection (Pro), and/or Payments (Pro).
- Publish and test on the live (or preview) site. Payment checkout and spam checks run on the live site.
Content
Where: Manual overview → Content drill row
Where: Settings → Content
- Set Collection (Wix CMS only — Forms do not use external databases).
- Choose which Fields visitors fill (Number and URL fields get matching input types; Color uses a native picker and saves HEX; Date / Date & time / Time pickers; image, Video upload, Media Gallery multi-upload; Reference and Multi-reference fields use a searchable dropdown loaded from the linked collection).
- When Create (Insert) on the collection blocks anonymous submissions, Settings shows a notice and Who can insert lets you adjust CMS permissions (or open the full permissions dialog). The editor canvas shows a dismissible banner while you design — same idea as Read permissions for displays on list widgets.
Reference fields
Reference and Multi-reference collection fields appear in Fields when your form collection includes them. In Field setup, choose a Display field from the linked collection for option labels. On the live form, visitors search and pick (10 items at a time, load more on scroll). Reference saves one related item id; Multi-reference saves multiple links after submit.
Filter options {#filter-options}
For a Reference or Multi-reference field, open Filter options in Field setup to restrict which linked collection items appear in the dropdown. Set Field, Condition, and Choose value — the same fixed-filter pattern as Search & filters on Table and Repeater. On a Reference / Multi-reference Choose value, you can pick This Page slug so options follow the current dynamic-page item — see This Page slug. Choose No filter to list all items (still subject to search and load-more on the live form).
Steps
Where: Manual overview — toggle Steps, then open the row
Where: Settings → Steps
- Turn on Multi-step form.
- Add steps and set each Step title (shown as progress and as section headers in Field setup).
- In Field setup, assign each field to a Step.
- Use Preview step in the editor to see one page at a time on the canvas.
- On the live form, visitors use Next / Back; submit runs on the last step. Progress shows Step N of M.
With multi-step off, all fields appear on one page (previous behavior).
Field setup
Where: Manual overview → Field setup drill row
Where: Settings → Field setup
For each field, set Label, Placeholder, Required, and Input type. When Members is on, Password and Confirm password appear on the live form (labels/placeholders editable here; passwords are never written to the collection).
Input type (Text fields): Text, Text area, Dropdown, Phone, Radio buttons, and Checkbox. Radio and Checkbox use custom Options under the type control; Checkbox saves a multi-select list. Boolean collection fields stay a single on/off checkbox.
Step (when multi-step is on): assign the field to a step. Fields are grouped under step headers in this section.
Show only when: hide the field until another field is empty, not empty, or Equals any of selected values. Required applies only while the field is shown. In the editor, fields that would be hidden show a hatch overlay so you can still find them.
Hidden fields {#hidden-fields}
Requirements: Pro plan.
On Text and URL collection fields (not reference fields or add-ons):
- Turn on Hidden field in Field setup.
- Choose Value source: Fixed text, URL query param, or Page URL (full URL when the visitor submits, including the query string).
- For URL query param, set the param name and optional If param is missing fallback.
- The field is omitted on the live form and filled automatically on submit (including Autosave drafts). Required and Show only when cannot apply while a field is hidden.
- In the editor, hidden fields show a Hidden badge and hatch overlay. Sites without Pro show normal inputs again so submissions keep working.
Values are not secrets — they are visible in the browser. Do not use hidden fields for API keys or passwords.
Submit
Where: Manual overview → Submit drill row
Where: Settings → Submit
- Optionally turn on Editable form or Autosave. Only one of those can be on.
- Set Button label, Submitting label, and Success message.
- Set After Submit: stay on the page, or navigate after a successful submit.
- Turn on Update displays on this page to reload Table, Repeater, Slideshow, Media Gallery, Calendar, Chart, and Dynamic Page widgets on the same page that use the same collection — full reference: Data refresh.
After Submit {#after-submit}
Under Submit, After Submit controls what happens when the form succeeds:
| Option | Behavior |
|---|---|
| Stay on Page (default) | Shows the success message and keeps the visitor on the form. |
| Navigate to Page | Opens another URL after submit. |
When Navigate to Page is selected, choose Navigate to:
- Dynamic page URL — Builds the item page for the row just created or updated (same Page path / Item slug pattern as Dynamic Page links). Use this for “submit then open the new listing.”
- Enter manually — Set a fixed URL (for example
/thank-youor an absolute link).
Navigation runs after a successful submit (including when pay-on-submit or Create contact / Create member still complete). If a Dynamic page URL cannot be resolved, the form stays on the page and shows the success message.
Autosave
Where: Settings → Submit
Autosave saves as visitors type. Turning on Editable form turns Autosave off, and the other way around.
- Turn on Autosave.
- Choose a Submitted field (boolean). Use Add submitted field to create one named Submitted when the collection does not already have it. That field stays off the form.
- Members need Read and Update on their own items. The panel offers Fix when those permissions are missing.
Members save a draft item in the collection with the submitted field set to false. Opening the form again resumes that draft. Submit updates the same item and sets the submitted field to true. Filter lists on that field when you want to hide unfinished drafts.
Visitors who are not logged in keep the draft in this browser until they submit. Submit then writes a new collection item and clears the browser draft.
The form shows Saving…, Saved, or Couldn’t save. Keep editing — we’ll try again. Passwords are not stored in the draft.
Contacts
Where: Settings → Contacts
- Turn on Create contact.
- Map Email (required) and optional slots: Phone, First name, Last name, Full name, Company, Job title.
- Prefer collection fields when you also want values saved in CMS. Use Add field (contact) for form-only fields that are not saved to the collection.
- To clear an optional mapping, use the X next to the dropdown. Email stays required while Contacts is on.
- Optionally turn on Update existing contact so a matching email updates that contact instead of creating a new one.
- Optionally turn on Assign contact labels (Pro) and pick labels from your site’s Contacts CRM. Labels are applied after Create contact runs.
When Create member is on, Contacts stays enabled so login email and profile fields stay mapped.
Members
Where: Settings → Members
- Turn on Create member (also enables Contacts).
- Set Login email (required).
- Map any other contact slots you want on the member/contact.
- Optionally turn on Log in after registration.
- Optionally turn on Assign Badges (Pro) and pick badges from Site members.
- Optionally turn on Add to groups (Pro) and pick Wix Groups. Badges and groups apply after submit when a member is created or matched by login email.
- Publish and test signup on the live site.
Spam & bot protection {#spam—bot-protection}
Where: Manual overview → Spam & bot protection drill row
Where: Settings → Spam & bot protection
Requirements: Pro plan. Without Pro, these toggles stay off on the live site even if they were saved earlier.
Reduce automated submissions. Open Spam & bot protection and turn on any combination:
- Use reCAPTCHA — Visitors confirm they’re human with Google reCAPTCHA (Wix Enterprise keys). Tokens are checked on submit and also cover Create member registration when that feature is on. Choose When to show reCAPTCHA:
- Always — visible challenge on the form.
- For suspected bots — invisible check on submit; most visitors never see a challenge.
- Honeypot field — Adds a hidden trap field bots often fill. Real visitors never see it; submissions with that field filled are rejected.
- Limit submission rate — Soft limit of about 8 submits per minute from the same visitor on app servers.
Rejected or rate-limited submits show a short error on the form and are not saved to the collection.
Wix Automations
Every successful Form submission reports a Form submitted event to Wix Automations (best-effort; does not block saving the submission).
In Automations, pick the CMS for Harmony Form submitted trigger. The payload includes submission id, collection id, submitted time, payment-pending flag, a JSON string of field values, and — when Contacts is mapped — email, name, phone, and contact id when available.
Form payments (Pro)
Where: Settings → Payments (Pro)
Form payments are separate from catalog payments (Add to cart / Buy now on displays). Here the visitor pays a fixed or entered amount when they submit.
- Connect a collection, then open Payments.
- Turn on Enable payments (installs Wix Stores if needed).
- Set Item name (line item in checkout).
- Choose Price: Fixed amount or Visitor enters amount (adds a required Amount field on the live form).
- Set the pay button Label.
- Under Save to submission, map Order ID, Total paid, and Payment status — filled after checkout when payment succeeds.
- Publish and test on the live site.
Without Pro, the payments toggle stays off and the panel shows an upgrade prompt.
Design
Where: Settings → Design
Set Field gap, Corner radius, Background, Border, Error color, Button background, Text, and Button text.
FAQ
Can the form navigate after a successful submit?
Yes — After Submit can Stay on Page or Navigate to Page (Dynamic page URL or manual URL). See After Submit.
Can forms block spam?
Yes on Pro — reCAPTCHA, honeypot, and submit rate limit under Spam & bot protection.
Can forms create contacts or members?
Yes — Create contact / Create member, with optional labels, badges, and groups. See Contacts and Members.