Skip to content
Flux Forms

Home / Core concepts

Forms and configs

Why a form is two records, and what "Active" actually means.

A form in Flux Forms is two things: a Form and a Form Config. Almost every confusing moment in the product traces back to not knowing which of the two you are looking at.

Form

The Form is the stable identity. It holds:

  • the Form Key — the unique, URL-safe public address, fixed after creation
  • the Label and description
  • the Active status — whether it is published
  • the Branding it uses

The Form Key never changes. Links you have already sent keep working for the life of the form.

Form Config

The Form Config is the content, and it is versioned. One version is the Active one — the live definition. A config holds, all as JSON:

  • Field Configuration — the sections and fields
  • Data Configuration — how fields are prefilled from Salesforce
  • Submit Actions — what happens when someone submits
  • Translations — the text, per language
  • Conditional Logic — the rules
  • End Screens — which thank-you a visitor sees

Why versioning matters

Every Form Submission records which config version it was filled in against. That is what keeps old answers interpretable: if you rename a field or remove a section next month, last month's submissions still point at the definition that was live when they were made.

The practical rule: create a new version rather than editing the live one when you are making substantive changes to a form that is already collecting answers.

What "working configuration" means

When you edit in the Form Builder and press Save, you are editing the working configuration — the Active version if there is one, otherwise the most recently edited draft.

Save updates that version in place. It does not create a new version, and it does not change whether the form is published. See Saving.

Active, precisely

Active on the Form is what makes it public. Two consequences:

  • Only the Active version is ever shown publicly. Drafts are never visible on the public link, so you can edit and save freely while the live version keeps running.
  • Deactivating takes it offline immediately. Visitors who open the link afterwards see an "unavailable" message. Existing submissions are untouched.

A form that has never been activated is not reachable at all.

Last updated: 2026-09-10