Forms Macro
The Forms macro is the container for every form you build in Confluence. It defines the Form ID and destination, and it holds all the other macros that make up your form, including input field macros and supporting macros.
Create a basic form
Edit the Confluence page where you want the form.
Insert the Forms macro.
In the Destination field add either the Form ID, an email address, or Confluence user name.
You can add any mixture of Form IDs, email addresses, and Confluence users.
- Enter a Subject in the field.
- Click Save.
- Add Input Field macros inside the Forms macro (e.g., Input, Dropdown List, Radio Button Group).
- Publish the page.
Customize the submit button
By default, the Submit button for the form is styled like a standard Confluence button.
You can customize the appearance using the Submit Button tab in the Forms macro.
From this tab you can:
- Change the Button text.
- Hide the Submit button.
- Add a CSS class so that the form can be styled with the Mosaic CSS Stylesheet macro.
- Directly apply CSS to the form with inline styles.
- Replace the button text with an image by adding a URL for an image.
Anonymous submission
By default, forms record the details of the logged-in user who submits them. If you want to allow anonymous submission, enable this option in the Forms macro settings. When enabled, user identity (username, email) is not stored with the response.
If anonymous submission is enabled, you cannot enforce Confluence Values.
Spam prevention (CAPTCHA)
To prevent automated spam submissions, you can add a CAPTCHA to the form. The CAPTCHA requires users to complete a verification step before the form can be submitted.
In the Forms macro Advanced Options tab, select Add a CAPTCHA.
Add response receipts
Adding response receipts allows users to get a copy of their answers as an email. This can be helpful when both you and the user completing the form need a copy of the answers. In the Forms macro Advanced Options tab, select Receipt.





