Creating a form in Confluence

ConfiForms app on Atlassian marketplace

Creating forms in Confluence with ConfiForms is very easy.

All you need is to define the form on the Confluence page using ConfiForms Form Definition and add ConfiForms Field Definition macros inside form definition macro body to define the fields.

You may also define the behaviour of your form using ConfiForms IFTTT Rules macro.

See more in these tutorials

• How to create a form to create a Jira issue from Confluence
• How to create a form to send emails
• How to create a form to send SMS messages

In this tutorial we create a simple form with just one text field to demonstrate the basics

1. Create a page in Confluence and add ConfiForms Form Definition macro
   
   
   
2. Give your form a name
   
3. Define a field
   
   
   
4. Give your field a name and title
   
5. Leave field's type as "Text" and click on "Insert" button
   
6. Add "ConfiForms Registrations Control (FormView)" macro to render the form view and enable registrations to this form
   
   
   
7. Form name shall be the same as in your Form Definition. This macro can be inside the CofniForms Form Definition macro, as well as outside. Can be on the same page, but can be on the different (even in a different Confluence space)
   In this example, we have it on teh same page and we can omit the "Page name where the form is defined" parameter
   
8. Click on "Insert" button
   
9. Now you can save the page and will see something like this
   
   There is an  "Admin UI" created for your to help you to see the data stored. as well as the form view.  "Admin UI", the one with the cog wheel and label "Form: myform" is visible only to the form administrators - users who have edit permissions on this page. It is not visible to ordinal users of your form
10. Now you can start capturing the data with your first form
    
11. That's it! The simple form is created! 
    
12. You can change the default as you like: altering the caption for "Save" button, changing the message, adding form title and changing the behaviour after the form is submitted
13. See how you can show the captured data: How to show the data stored with ConfiForms