Skip to content

Quickstart — publish your first form

Create a useful multi-page form in about fifteen minutes. At the end, you will have a validated draft, a published internal copy, a completion page, and a response you can review.

Open the service that owns the intake process and select Forms under Process Modules. Choose Create Form for a blank draft, From Schema for JSON, or Create with AI for a proposed first draft.

Create-from-schema dialog with form metadata fields

Use a specific name, purpose, and table prefix. For example:

  • Name: CareArc Patient Access & Support Request
  • Description: Service-ready intake for appointment access and support
  • Table prefix: carearc_access_docs

Add one page for each respondent decision, not every individual field. A practical structure is:

  1. Contact details
  2. Request details
  3. Documents and consent
  4. A submission-complete page

Double-click a page tab or focus it and press F2 to rename it. Press Enter or move focus away to save the name; press Escape to cancel.

Set the last page’s Page purpose to the submission-complete page. It carries a Complete badge in the page strip, and it is excluded from respondent steps and from stored answers.

Use the Fields palette for respondent inputs and display content. Use Layout for sections, repeaters, tabs, and visual containers. Select an item on the canvas to edit its label, description, width, validation, database name, or style.

Forms builder overview with palette, pages, canvas, and properties numbered

Keep field labels conversational and keep database field names stable. Put repeating records such as attendees or line items in a Repeater so each row is stored in a child table.

Mark genuinely required fields as Required field. Use Configure Validations for reusable rules, then add length, pattern, or corrective guidance only when it helps a respondent recover.

Validation rule dialog for a selected form field

Choose Preview, then test desktop, tablet, and phone. Select Next with required answers missing and confirm that every error identifies the problem next to the relevant field.

Preview showing required-field messages and a page error count

Use the locale and time-zone controls when the form contains date, time, or date-range fields. Preview changes are test settings; they do not rewrite the saved respondent data.

Open Submission actions. A common sequence is:

  1. Show completion page
  2. Show submit-another-response button

Open Internal & external publishing. Enable the Internal Publisher for authenticated use, choose an external publisher only when anonymous delivery is intended, and review Internal access before release.

Publishing locations dialog with the internal publisher selected

Choose Publish, add a concise version note, and confirm. The toolbar replaces Not published yet with View Published Form.

Open the published form, complete each page, and submit. Confirm that the completion page appears only after storage succeeds.

Successful completion page with a submit-another-response action

Return to the form catalogue. The card should show the updated response count. Choose View Data to inspect the response, any repeater child rows, and the Export CSV action.

Next, read Build fields and validation or Publish, submit, and recover.