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

  1. Edit the Confluence page where you want the form.

  2. Insert the Forms macro.

  3. 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.

  4. Enter a Subject in the field. 
  5. Click Save.
  6. Add Input Field macros inside the Forms macro (e.g., Input, Dropdown List, Radio Button Group).
  7. 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 tabselect  Receipt. 

Select Include destination in the receipt to add all email addresses from the destination list to the receipt. 
On this page