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

What you are seeing

A Confluence page where the Form macro shows the red message Configure this macro with a Form ID before readers can submit values
A Form macro with no Form ID shows this message instead of its fields. Edit the page and give the Form macro a Form ID to fix it.

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


#Why it happens

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


#What to do

Edit the page, open the Form macro's config panel, and set a Form ID such as employee-onboarding.


#Limits that apply here

Limit

Value

What happens

Standalone field autosave delay

800 ms after the last change; "Saved" ti

Applies only to Input macros outside a Form container.

Save retry ceiling

5 attempts, backing off 250 ms, 500 ms,

If the save cannot locate the macros in the page content it retries on that ladder and then gives up, surfacing as "Could not save form - try again".


#A few things that catch people out

  • Form ID is documented as required but nothing stops you saving the config without it - the macro just renders an error box on the page.

  • A form is a single stored record on the page, not a submission log. A second person overwrites the first, and "Responded by" shows only the newest saver.

  • Option colours, per-option descriptions, Allow multiple selections, number Minimum/Maximum, Allow decimals and the character-length settings live only in the bespoke config panel, so they will not appear in any generic macro-parameter rendering.



Found it? Good.