The original ProForma form builder, launched in 2016, allowed you to create forms using sections, questions and information areas. In early 2020, we introduced a new form builder, which uses the Atlassian Document Format (ADF) which is now the standard form builder. The updated form builder allows for expanded formatting options. 

Forms created in the original form builder (Legacy Forms) will continue to be supported. However, future development will be focused on the standard form builder.

Images in the documentation reflect the standard form builder.

How are Standard Forms Different from Legacy Forms?

The legacy form builder allows you to create forms using three basic elements: Questions, Sections and Information Areas.

An optional feature (must be enabled on the ProForma configuration page) lets you add formatting, images and links to information areas using HTML.

The standard form builder differs from the legacy form builder in that:

  • There is no insertable element for Information areas. Instead, the entire background of the form/document can be used for providing information and instructions.

  • In addition to the Build and Settings tabs, there is also a Preview tab that allows you to test your form and to see how it will appear to the user, and a JSON tab that lets you see the data format.

  • You can add default values for any question.

  • You can create nested conditional sections.

  • More formatting options are available (rich text formatting, page layouts, tables, insert panels, etc.).

Which Form Builder Should I Use?

When you create a new form, you'll be given the option of creating a standard form or a legacy form.
It is recommended that you create new form templates as standard forms because:

  • You can create better forms.

  • The standard form builder lets you preview and test your forms to see how the form will function for the end user. 

  • While the legacy form builder will be supported with bug fixes as needed, we will be focusing our future development efforts, including any new features, on the standard form builder and form system.

How Can I Convert a Legacy Form to a Standard Form?

To convert an existing (legacy) form to a standard form, you will need to copy the form as a standard form:

To convert an existing (legacy) form to a standard form, you will need to copy the form as a standard form:

  1. Go to Project Settings for the target project.

  2. Click on Forms.

  3. Find the form you want, and click the Copy button.

  4. Select the target project from the dropdown. It can be the same project you are in, or another project.

  5. A copy of the form will open as a the standard form.

  6. You can now delete the legacy form template. Deleting the template will not impact existing forms on Jira issues.