Unable to add or remove a Release Vehicle from a Story in Jira Align

Platform Notice: Cloud and Data Center - This article applies equally to both cloud and data center platforms.

Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

In the details of a Story, the Release Vehicle dropdown may be missing one or more of the Release Vehicles. It is also possible that a Release Vehicle will be displayed underneath the Release Vehicle drop-down that cannot be removed.

This article discusses the causes of both conditions and how to resolve them

Environment

Jira Align

Cause

Release Vehicle not displayed in the field dropdown

Availability of a specific release vehicle in the dropdown (in the Story details panel) is linked to which Program Increment (PI )is set in the Program Increment Shipped In field of the Release Vehicle itself. If a PI is chosen that is not connected to the same Portfolio/Program as the story then the Release vehicle will not be displayed in field dropdown of the story details.

Unable to delete a Release Vehicle from a Story

If a Release Vehicle was originally added using the dropdown in the details panel of the Story, then it will show inside the dropdown

(Auto-migrated image: description temporarily unavailable)

If the Release Vehicle was originally added to the parent Feature of the Story, then in the details panel of the Story it will show underneath the Release Vehicle dropdown and not in the dropdown itself.

(Auto-migrated image: description temporarily unavailable)

⚠️ It is possible to set a Release Vehicle in both the feature and the story, which will show in both locations discussed above

ℹ️ Extra information for those using Enterprise Insights: If the Release Vehicle was originally set via the Feature, then a query for Release Vehicles from the Story table in Enterprise Insights will not return any data

Solution

Release vehicle not displayed in the field drop-down

  1. Go to Program > Release Vehicles

  2. Locate the affected Release Vehicle and open the details

  3. Check which PI is set in the Program Increment Shipped In field (if incorrect change it)

  4. Click inside the Contributing Programs field - a list of programs will appear, if the program that the story belongs to is not listed, then open up the details of the PI and make sure the program is added to the PI.

  5. The above steps should make the Release Vehicle visible in the details of the Story.

Unable to delete a Release Vehicle from a Story

If the Release vehicle is shown inside the dropdown, then click the drop-down and then click the checked entry in the resulting list, which will remove the check mark. Then Click Save

(Auto-migrated image: description temporarily unavailable)

If the Release vehicle is shown below the dropdown, then either edit the Feature to remove the release vehicle, OR assign the story to a different Feature.

Related Content:

Create a release vehicle for an actual release to market

Updated on April 14, 2025

Still need help?

The Atlassian Community is here for you.