Jira Software: Plan a cross-project release

Jira Software Evaluator Resources

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community


Can I plan a cross-project release in Jira Software?




Cross-project releases are used to manage joint releases, dates, and milestones across multiple individual projects. When you create a cross-project release and commit it to Jira Software, the release will be transformed into a regular release in each of the Jira projects that are part of the cross-project release. Issues assigned to the cross-project release in Portfolio will be assigned to the respective project-specific release in the issue's Jira Software project.

How to create a cross-project release

Create cross-project releases by following these steps:

  1. Go to your plan > Releases > + Create release.
  2. Select the release name, choose Cross-project release.
  3. Click Add and select the projects that will be sharing this release.
  4. Select the dates.
  5.  Once you are happy with the configuration click Create release.
    Your new cross-project release will be visible under Releases.

How to group existing releases

You can group already existing project-specific releases by following these steps:

  1. Check the boxes of the releases you want to group and click Group releases.

    Your new cross-project release will be visible under Releases. The cross-project releases' dates are aggregated from the project-specific releases. The start date will be the earliest start date and the end date will be the latest end date from the project-specific releases.

How to manage a cross-project release

  1. Select the release you want to modify and click Edit to see the detailsFrom here you will be able to edit, remove, delete, add more releases and align project-specific release dates.


    When you create a new cross-project release, a new project-specific release is created per project with the same details.

  2. You can align the dates of the project-specific releases by going to the details view, clicking Align dates and selecting the configuration. 
    The changes will apply to all the releases that are part of the cross-project release.
  3. Add more releases to an existing cross-project release by going to the release details view and clicking Add release.

How to delete a cross-project release

Select the cross-project release you want to delete and click  and click Delete.

You can delete a cross-project release without deleting their children by un-checking the box in " Exclude all releases that are part of this cross-project release from this plan as well.


In the following case, the TIS company has to improve the loading data time in Android since they are receiving users complaints. In order to accomplish this project, the backend team will have to work with the Android client side team. Each team works on different projects and releases and they have to combine efforts to get this improvement done.

  1. Create a cross-project release by following the instructions provided above. In this release, you will be including both, Performance and Android teams.

  2. Once the cross-project release has been created, Portfolio for Jira creates a project-specific release called "Data load system improvements" for each Jira Software project as you can see in the caption above.

Additional Information:

Last modified on May 7, 2018

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.