Available custom fields for team-managed projects

There are a few different types of fields you can customize to capture different types of information on your team-managed project's work types. Learn more about fields in team-managed projects.

Fields in team-managed projects are contained within the project itself. Currently, you can't share a field created in one team-managed project with another team-managed project, or with a company-managed project. Find out more about custom field types in company-managed projects.

Checkbox fields

Checkbox fields allow people to select multiple options from a list. In company-managed projects, these are called "select list (multiple choices)" or "multi-select" fields. Checkbox fields help with data entry by reducing entry errors that could appear in free-form text fields, for example. They also increase correct completions by limiting the options a person has to complete the field.

You can add up to 55 options to a checkbox field.

Date fields

Date fields allow people to provide date information using a calendar selection. In company-managed projects, these are called "date picker" fields. People can also complete the field by typing dates into the field.

Dropdown fields

Dropdown fields allow people to select a single option from a list. In company-managed projects, these are called "select list (single choice)" or "single-select" fields. Dropdown fields help with data entry by reducing entry errors that could appear in free-form text fields, for example. They also increase correct completions by limiting the options a person has to complete the field.

You can add up to 55 options in a dropdown field.

Labels fields

Label fields allow people to tag work items with reusable text snippets entered as free form text. Jira suggests existing labels to help reduce entry errors. People can also create new labels by typing into the label field.Labels are pretty powerful as your project matures. They can be used for sorting and filtering work items on the board, as well as reporting.

Number fields

Number fields allow people to provide numerical information as free-form text. A single line text box allows people to complete the field with a number. People can safely enter numbers between -1 trillion and 1 trillion (100,000,000,000,000). 

Keep in mind:

• Jira rounds decimals to the nearest 1000th place. For example, 5.555555 will be rounded to 5.556. 

• People can enter large numbers using scientific notation. For example, the number 5,000 can be entered as 5e3.

Paragraph fields

Paragraph fields allow people to provide information as free-form text. In company-managed projects, these are called "text field (multi-line)" or "multi-line text" fields. The field appears as a rich-text editor, allowing people to format the text with headings, bold, italic or other font treatments.

People can also complete the field by including links, @mentions, emojis, info panels and other rich text components. The field's size and treatment is meant to encourage detailed, longer-form responses to complete the field.

You can add up to 32,767 characters into a paragraph field.

Admins can set default values for paragraph fields, including predefined Tasks or Decisions. This improvement allows you to standardize work item descriptions and paragraph fields, and gain consistency across team-managed projects.​

Currently, you can only add paragraph fields to the Description section of your work types in team-managed software projects.

People fields

People fields allow your team to insert people’s names from across your Jira site into a field on your work item. In company-managed projects, these are called "user picker" fields. If you want to use names of people outside your Jira site, use the short text or labels fields instead.

Jira doesn't send notifications to people when you use their name to complete a custom people field.

By default, the people field allows you to insert multiple names to complete the field. You can restrict the people field to only accept a single person by ticking the Restrict to a single person checkbox.

Take care when restricting a field to a single person, especially if the field has been in use in your project. If you have work items that collected multiple people in a field and, later, you restrict that field to a single person, a few things happen:

• The field will only accept a single person in any newly created work items.

• Previously created work items that contained multiple people in your field will retain all the people associated with the field. However, if you edit the work item, Jira will ask you to fix the field so it only contains one person.

• Any Update a work item field rules on your board that use the field will break. Since Jira doesn’t know the most appropriate person to complete the field automatically, we don’t complete the field at all. We recommend you remove these rules and recreate them.

Short text fields

Short text fields allow people to provide information as free-form text. In company-managed projects, these are called "text field (single line)" fields or "single-line text" fields. This field appears as a single line text box, to encourage concise responses for completing the field. It captures only plain text responses.Currently, you can only add short text fields to the Context section of your work types in team-managed software projects.

Time stamp fields

Time stamp fields allow people to provide time of day information using a calendar and dropdown time selector. In company-managed projects, these are called "date time picker" fields. Time stamp fields have two input areas: one to specify the date, and one to specify the time.

The time tracking field

The time tracking field allows people to log how much time they work on a work item. It also shows how much time is remaining after your team first estimates the work needed. Read more about logging time.