Everything else

Start from what you are seeing rather than from what you think is broken. Each page below names the symptom, explains why it happens, and says what to do about it.

Several of these are the product working as designed, which is worth knowing before anybody raises a ticket.


#At a glance

Symptom

Usually because

Input type dropdown shows most types greyed out with an "Advanced" badge

Standard edition without the confluence.forms flag. Only single-line text is selectable. The same thing happens transiently if the feature-flag service is slow or fails, because the gate tre

Page shows "Configure this macro with a Form ID before readers can submit values."

The Form container has no Form ID. Nothing prevents saving the config without one.

Form shows "No input fields yet. Edit the page and insert Input macros inside this form."

The Form container's body is empty, or the Input macros were placed on the page next to the container rather than inside its body region.

Save is blocked with "Fix validation errors before saving"

One or more fields failed validation - a Required field is empty, a URL is not a safe web address, text is outside the character limits, or a number is non-numeric, not whole with decimals o

"Could not save form - try again"

The save could not locate the form's macros in the page content. It retried five times over about nine seconds and gave up. Usually the page was edited concurrently, or the page structure ch

Required fields and character or number limits are being ignored - people are saving anything

The fields are standalone Input macros, not fields inside a Form container. Standalone fields autosave 800 ms after typing and are never validated.

Someone's answers were replaced by someone else's

By design. A page holds exactly one record per form, not a log of submissions. A second person filling the same form on the same page overwrites the first person's answers, and "Responded by

Changing a field's Input type wiped its answer and its settings

By design. Switching type clears the stored value and drops settings that do not apply to the new type - options, multi-select, placeholder, number bounds and length limits.

Two fields' answers merged into one column in the responses table or CSV

Two fields on the same page share a Field ID. The index keys answers by Field ID, so the later field silently overwrites the earlier.

Large form's answers stopped appearing in the byline, the catalogue and property search - but they a

The page's forms exceeded the 28,000-character index cap. Multi-value answers were truncated to their first 5 entries, then whole forms were dropped, and in the worst case the page was recor

Columns in the responses table change as I page through

The field columns are built from whichever fields appear in the 25 rows currently on screen, not from the form's definition. Pages whose form omits a field will not contribute that column.

Catalogue's "Responses" number does not match how many people have replied

That column counts PAGES carrying the form, not submissions. It counts a page even when no field on it was ever filled in.

Confluence labels starting capable_forms_ keep reappearing on our pages

Forms adds capable_forms_page and one capable_forms_{formId} label to every page carrying a form, as the app, and re-applies them whenever the page is re-indexed. It also deletes labels matc

Filled the form while editing the page and the answers did not appear for anyone else

Saving a form from inside the page editor writes to the DRAFT, not the published page, and the index is rebuilt from that draft.


#In this section

Input type dropdown shows most types greyed out with an "Advanced" badgeThe Input type dropdown shows most types greyed out with an "Advanced" badge.Page shows "Configure this macro with a Form ID before readers can submit values."The page shows "Configure this macro with a Form ID before readers can submit values."Form shows "No input fields yet. Edit the page and insert Input macros inside this form."The form shows "No input fields yet. Edit the page and insert Input macros inside this form.".Save is blocked with "Fix validation errors before saving"Save is blocked with "Fix validation errors before saving"."Could not save form - try again""Could not save form - try again".Required fields and character or number limits are being ignored - people are saving anythingRequired fields and character or number limits are being ignored - people are saving anything.Someone's answers were replaced by someone else'sSomeone's answers were replaced by someone else's.Changing a field's Input type wiped its answer and its settingsChanging a field's Input type wiped its answer and its settings.Two fields' answers merged into one column in the responses table or CSVTwo fields' answers merged into one column in the responses table or CSV.Large form's answers stopped appearing in the byline, the catalogue and property search - but they aA large form's answers stopped appearing in the byline, the catalogue and property search - but they are still visible on the page.Columns in the responses table change as I page throughThe columns in the responses table change as I page through.Catalogue's "Responses" number does not match how many people have repliedThe catalogue's "Responses" number does not match how many people have replied.Confluence labels starting capable_forms_ keep reappearing on our pagesConfluence labels starting capable_forms_ keep reappearing on our pages.Filled the form while editing the page and the answers did not appear for anyone elseI filled the form while editing the page and the answers did not appear for anyone else.


Most of these are expected behaviour.