Jira Team is not automatically assigned to Jira Align work items

Platform Notice: Cloud Only - This article only applies to Atlassian products on the cloud platform.

Summary

The Jira Team is not being automatically assigned to the newly created JA work items.

OR The Jira Team is assigned incorrectly in Jira Align.

Environment

Jira Align

Diagnosis

The JA work item team field is empty or incorrect.

(Auto-migrated image: description temporarily unavailable)

Cause

Multiple causes:

  1. Team is not mapped for the project board in Administration > Jira Management > Jira Boards

    (Auto-migrated image: description temporarily unavailable)
  2. Team is a custom field on Jira and has not been setup in

    Administration > Jira Settings > Manage Project > Manage Custom Fields > Sync Jira Team Values with Jira Align Teams

  3. The Jira board belongs to more than one project

  4. The work item was assigned to a sprint that has been locked in Jira Align.

  5. If the Jira Project has multiple Jira Boards and the Boards are assigned to different teams (this is a supported structure, but only if configured correctly)

  6. Administration > Jira Settings > Jira Setup > Allow Jira to update the team field for stories is set to NO

  7. The board's parent project is included in the filter's Edits permission instead of the filter's Shares permission.

Solution

  1. Check that the Jira project board is listed in JA Administration > Jira Management > Jira Boards and that the correct Team has been assigned to it. Sometimes spelling errors occur, as it is not a dropdown field.

  2. Check if the Jira Team field is a custom field in Jira (see expand below)

  3. If so,

    a. All teams are affected: check that the correct Jira custom field ID has been entered into JA Administration > Jira Settings > Manage Project > Manage Custom Fields > Sync Jira Team Values with Jira Align Teams

    b. One or a few teams are affected: check that the team has been entered into

    JA Administration > Jira Settings > Manage Project > Manage Custom Fields > Sync Jira Team Values with Jira Align Teams

  4. Check if the Sprint is locked and try unlocking it

    (Auto-migrated image: description temporarily unavailable)
  5. If the board's parent project is included in the filter's Edits permission, remove and add it under the filter's Shares permission:

    (Auto-migrated image: description temporarily unavailable)

Check if the Jira Team field is a custom field in Jira

In Jira Cloud

Go to https://{yourJiraSite}.atlassian.net/secure/admin/ViewCustomFields.jspa and search for the Team field

In Jira Sofware DC/Server

ℹ️ Please note, that the "Administer Jira" Global permission is necessary to complete these steps.

Navigate to Settings (:cogicon: ) > Issues > Custom fields under the Fields section

Reference: How to find any custom field's IDs | Jira | Atlassian Documentation

Related Content

Updated on April 2, 2025

Still need help?

The Atlassian Community is here for you.