Teams in Jira projects

We’re rolling out the new Team custom field in Jira across all plans in the coming weeks.

Join the conversation if you have any questions or feedback.

You can add the Team custom field to your projects in Jira.

The Team field allows people to:

  • associate issues with a specific team

Jira issue description showing the team field with a team assigned.
  • Search or filter results to a specific team

Jira basic search with team filters.

Enabling the team field for company-managed projects

The Issue Layout page in a Jira Project's settings.
  1. Open a company-managed project and select Project settings from the left panel.

  2. From the left panel, select Issues Layout.

  3. Select Edit issue layout for the issue types where you want to use the Team field.

  4. From the panel on the right, search for the Team field in the search box.

  5. Drag the Team field to the section that you want to add it to.

  6. Press the Save changes button at the bottom.

Enabling the team field for team-managed projects

The Issue Types page in a team-managed project's settings in Jira.
  1. Open a team-managed project and select Project settings from the left panel.

  2. From the left panel, select Issue type.

  3. From the panel on the right, search for the Team field in the search box.

  4. Drag the Team field to the section that you want to add it to.

  5. Press the Save changes button at the bottom.

Automation using the Team field

You can create new rules using the Team custom field to automate your work around Jira projects.

An automation flow in Jira with a Team change as the trigger.

If you encounter an error with the Team field when using automation, check the Audit Log to see what went wrong.

Audit log in Jira automation, showing a rule has run twice successfully, once with errors, and once with config changes.

In some cases, the error may be related to using an open site.

Use a post function to update the Team field

When using the Team field with advanced issue workflows, you must use the Team UUID value instead of the team name. 

To add a post function which updates the Team field:

  1. Select Update Issue Custom Field from the Add Post Function screen.

  2. Select Add.

  3. From the Issue Custom Field dropdown, select Team.

  4. For Custom Field Value, you must enter the Team UUID.

To get the Team UUID:

  1. Go to the team profile page.

  2. Copy the value of the Team UUID from the URL. For example: https://yoursite.atlassian.net/people/team/[TeamUUID]

  3. Paste the Team UUID to Custom Field Value.

Additional Help