Teams in Jira projects

The Team custom field is now available on the Free, Standard, and Premium plans for Jira Software, Jira Work Management and Jira Service Management. Join the conversation to share any questions or feedback.

What is an Atlassian team?

You can add the Team custom field to your projects in Jira products. You must have Browse users and groups permission in order to use the field

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.

Note for Advanced Roadmaps users: the Team field on sandbox sites may not work as intended and may exclude teams from search results. We are working on resolving this issue, and hope to have sandbox sites working properly.

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