Customize an issue's fields in next-gen projects


Define and customize the fields that appear in your next-gen software issues' details. Add more fields or edit the view for each of your issue types.

The foundation of every Jira issue is its key, summary, and a status. With this information, you can track simple tasks and stay on top of your project's work.

We know that some tasks require more information to help along the team taking on that work. So, Jira can collect and display more information to provide context and get work on its way to done.

This extra, customizable information appears in an issue's fields. And, you can customize each issue type to show different fields.

You must have the administrator role in your project to do the things described on this page. Learn more about next-gen project roles.

How fields appear on your issues

When you add fields to your issue types, they appear on all issues of that type.

  1. Fields you add to Description fields in your project's settings appear in the main content area of your issues.
  2. Fields you add to Context fields in your project's settings appear on the right side of your issues.
  3. If you drag fields under the Hide fields below dotted line, they appear on your issues when someone completes the field. If the field is empty, it’s hidden. Select Show more when viewing an issue to interact with hidden fields.

Add, reorder, or remove fields

To add a field to your issue type:

  1. From your project's sidebar, select Project settings > Issue types.
  2. Select the issue type you want to edit.
  3. Drag fields from the toolbar into the list of fields. Jira highlights the areas you can drop the field into.

The previously-created fields list contains:

  • fields you created on other issue types
  • fields Jira Software created for you
  • fields 3rd-party apps created for you

You can drag previously-created fields into your issue type to reuse them. Using the same field between more than one issue type makes it easier to sort, search, and report on those fields.

When a field appears on more than one issue type, the fields share the same name and description. If you change the name in one issue type, it will change in the others that use that field. Checkbox and dropdown fields also share their available options. But, the field can have a unique default value on each issue type.

To remove a field, drag the field back into the fields toolbar.

To rearrange the order of fields in the new issue view, drag and drop the fields into the order you prefer.

Default fields

By default, Jira adds a few fields to your issue types that we think help provide context to your project's work. They are:

  • Summary – a brief, one-line summary of the task. This field is always required in Jira.

  • Description – details of the work needed to complete the task.

  • Status – the current workflow status and available transitions that move the issue through the workflow.
  • Assignee – the person assigned to the task.
  • Reporter   the person who brought up the issue or task. Usually, this is the same as the person who created the issue. Some teams create issues in a working group or using a shared computer. These teams might need to adjust the reporter when creating issues.
  • Labels – tags used to group, filter, or search for issues. 

Jira also comes with a few commonly-used fields you might consider adding:

  • Priority – the importance of the issue or task in relation to others in the project. Only Jira administrators can customize what priority levels are available across their Jira site. Learn more
  • Due date – the agreed time and date when the issue or task should be resolved.

Create custom fields

To create a new custom field:

  1. From your project's sidebar, select Project settings > Issue types.
  2. Select the issue type you want to edit.
  3. Under Create new field, drag the type of field you want to create. Jira highlights the areas you can drop the field into. Learn more about the available types of custom fields.
  4. Give your new field a name.
  5. Configure any extra field options, like adding a description for your team or setting a default value.
  6. Select Save changes.

Your new field is also available to your project's other issue types in their Previously-created fields lists.

You can only add a custom short text field to the Context section of your issue types. Similarly, you can only add a custom paragraph field the Description section of your issue types.

Last modified on Oct 13, 2019

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.