Creating and configuring cross-project releases

Still need help?

The Atlassian Community is here for you.

Ask the community

This page discusses the usage of Portfolio for Jira live plans (any version from 2.0 to 2.27). If you're using the redesigned planning interface, see this page instead.

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, 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 for Jira will be assigned to the respective project-specific release in the issue's Jira project.

Creating a cross-project release

  1. Go to your plan via Portfolio (in header) > View Portfolio > click your plan.
  2. Click the Releases tab to display the releases section below the timeline.
  3. Click + Create release.
  4. Give the cross-project release a name.
  5. Select Cross-project release for the release type.
  6. Click the project menu, then select the projects that will be sharing the release.
  7. Configure the start date and release date. See Configuring release dates for more details.
  8. Click Create release.
    Your new cross-project release will be visible under Releases.

Adding an existing release to a cross-project release

  1. Go to your plan via Portfolio (in header) > View Portfolio > click your plan.
  2. Click the Releases tab to display the releases section below the timeline.
  3. In the Cross-project releases section, click the cross-project release. The release details will display.
  4. Click Add release to add an existing release.
  5. Select the release you want to add to the cross-project release.

Grouping existing releases

  1. Go to your plan via Portfolio (in header) > View Portfolio > click your plan.
  2. Click the Releases tab to display the releases section below the timeline.
  3. Check the boxes of the releases you want to group and click Group releases.

Your new cross-project release will be visible under Releases. In the cross-project releases, the release 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.

Managing a cross-project release

  1. Go to your plan via Portfolio (in header) > View Portfolio > click your plan.
  2. Click the Releases tab to display the releases section below the timeline.

  3. Select the release you want to modify and click Edit to see the details. You can then 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.

  4. 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.

Deleting a cross-project release

Select the cross-project release you want to delete 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.

Example

In the following case, the TIS company has to improve the loading data time in Android since they are receiving users complains. 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 project as you can see in the image above.

Related topics

Last modified on Jan 12, 2020

Was this helpful?

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