SEED

⚠️ Seed BEFORE building the form UI. This is the one vertical that does not run in parallel with the client: the page renders the fields this creates, and imports the id it returns.

Additive only — an existing form with the same name is left exactly as it is and reported with created: false. Re-running never makes a second copy and never edits one.

Run

Plan

Kinds

text · textarea · email · phone · url · firstName · lastName · company · date · number · rating · select · radio · multi · checkbox · file · address

email, phone, firstName, lastName, company are the CONTACTS kinds — Wix maps them onto the owner’s CRM contact, so prefer them over a plain text field for those.

Result

formId is what the page imports. fields[].target is each input’s name — the page does not need them (it renders form.fields from the live schema), but they are the keys the owner’s submissions are stored under.

degraded must be empty. It is the read-back check: the seed re-reads the created form and compares each field’s componentType against what it sent. A non-empty list means a field was accepted and then stored as something else — almost always a choice field that lost its options and became a plain text box. Fix the plan, delete nothing, and create the form again under a new name; a 200 on create does not mean the field survived.

What the seed does

1. Installs the Wix Forms app (idempotent).
2. Lists existing forms in the wix.form_app.form namespace — a name match is skipped.
3. Expands each field, creates the form, reads it back and checks every componentType.

Traps this seed already handles

Listed because a hand-rolled payload hits all of them, and each returns 200 first:

• A choice field declares its options twice — the component’s options[] and the validation enum (or items.stringOptions.enum + itemType for a multi). Disagree and the field is created as a plain text box.
• validation must be present even when empty, nested under the input-type block, not the component one. Absent, the target is not registered as an accepted value and every submission is rejected with UNKNOWN_VALUE_ERROR on a key that IS in the schema.
• required lives at inputOptions.required, never inside a validation block.
• steps must reference every field, the submit button included. A field missing from the layout never appears in the owner’s dashboard — they cannot edit what the site renders.
• target is immutable and must be unique within the form: letters, digits and single underscores, starting with a letter.
• Use formFields, never fields — the latter is the legacy API.