Create a Form on an Existing Page

Forms for Confluence doesn't just create standalone pages — you can also add a form directly to an existing Confluence page.

Forms for Confluence doesn't just create standalone pages — you can also add a form directly to an existing Confluence page. This lets you gather feedback, requests, or survey responses right alongside your content.

Prerequisites

To add a form to an existing page, you need a Form ID that defines where responses will be stored.

Confluence Admins can create Form IDs for any space, including advanced destinations like email relay or Jira.
Space Admins can create Form IDs for their own space, but these are limited to the internal database.

If you don't have the right permissions, contact your space or Confluence admin.

When to Use a Form in an Existing Page

Adding a form to an existing page is useful when:

You want to capture feedback directly in documentation.
You're gathering approvals or input on a project page.
You're running a survey or poll as part of an ongoing discussion.

This approach keeps the context and the form together, making it easier for users to provide relevant responses.

Add the Forms Macro

Open the page where you want to add a form and switch to Edit mode.
Insert the Forms macro from the macro browser.
In the Destination field, select or enter the Form ID you want to use.
You can select multiple Form IDs to save the data in more than one place. You can also add email addresses or Confluence users names to send responses to.
Click Insert.

At this point, the form is linked to your chosen Form ID, but you still need to add the fields you want to build your form.

Add Your Questions

Inside the Forms macro, insert the input field macros you need, for example:

Input Field for short answers.
Textarea for longer text.
Radio or Checkbox Groups for multiple-choice questions.
Dropdowns,Star Ratings, or Conditional Fields for richer surveys.

Each field macro you add will be tied to the Form ID you selected.

Save and Test

Once you've added your fields, save the page and submit a test response. This ensures the form is working as expected and responses are correctly linked to the results database or destination you configured.