• Products
  • Get started
  • Documentation
  • Resources

How do forms work in the issue view?

The features described on this page may not yet be available on your Jira Service Management site. To find out when these features will be live on your site, keep an eye on our release notes or the Atlassian Community.

All forms behave the same way in the issue view, regardless of whether they were filled out in the portal, used to create the issue, or added to the issue manually. Learn more about the issue view.

Once an issue is created, you may want to add a checklist, or collect more information from your customer or team members. By adding a form to an issue, you can collect information quickly, and all in one place. Learn how to view, add, or edit a form on an issue.

In the issue view:

  • Forms used to create the issue or added to the issue later appear under Forms.

  • When a customer has raised a request from the portal, any information they entered in regular Jira fields will appear at the top of the issue as usual, and the form they filled out will appear under Forms.

  • New forms can be added to issues at any time.

  • Agents and admins can view a form and its information by selecting it.

  • Forms added to issues are set to internal by default, meaning that only agents and admins can access the form from the issue. Forms can be set to external, which also allows customers to access the form from the portal.

  • Forms used when raising a request in the portal are set to external by default. Learn how to add a form to the portal form for a request type.

  • Depending on a form’s state and settings, an agent or admin may be able to reopen and edit a submitted form, and allow a customer to return to the request in the portal to edit and resubmit a form. Learn more about form states, or about form settings.

Example

Let’s say a customer raised a request in the portal. The portal form for the request type they raised was configured so that the customer had to fill out some Jira fields, as well as a form. When viewing the issue, you can see the Jira fields they filled out at the top of the issue view, and the information filled out in the form under Forms.

After viewing the issue, you realize you need to get your customer’s address and phone number. You add an “Address and phone number” form to the issue, set it to external, and add a comment to the issue letting the customer know there’s a new form on their request that they need to fill out.

The customer returns to their request in the portal, fills out the newly-added form, and submits it. You return to the issue and view the form they just filled out. Now you have the information you need to keep working on the request.

Additional Help