Creating and configuring cross-project releases

Still need help?

The Atlassian Community is here for you.

Ask the community

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.
    Configuring release dates
    Start DateDescription
    As early as possibleThe release will start as soon as there are available resources.
    Fixed dateRelease start date is set to the chosen date.
    Relative to previous release dateThis option allows you to specify the amount of time gap that you want to leave once the previous release is finished and the work on the new one starts.
    Release DateDescription
    Fixed dateRelease end date is set to the chosen date. In the graphical schedule, you'll see a buffer if there is free capacity, or it will be shown as overbooked in red color.
    Dynamic release dateThe release end date will be dynamically settled. The scheduler automatically fits in as many items as possible into the release based on their priority. The release can never get overbooked.
  5.  Once you are happy with the configuration click Create release.
    Your new cross-project release will be visible under Releases.

How to add an existing release to a cross-project release

Once you've created a cross-project release, you can group existing releases into the cross- project one.

  1. Go to Releases > Cross-project releases
  2. Click the Cross-project release name.
    Now you can see the details page.
  3. Click Add release button to add existing releases.
  4. Select the release you want to add. Keep in mind that you can only have one release from a project in the cross-project release.

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 details. From 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.
Last modified on Jan 30, 2018

Was this helpful?

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