Creating and deleting programs

Still need help?

The Atlassian Community is here for you.

Ask the community

A program is a high-level view that helps you track status and progress across multiple plans in Portfolio for Jira. Programs let you see how deliverables and releases align across work streams, and aggregate scope data into high-level scope tables and schedule views.

Programs and plans are different in the sense that they display information at different levels of granularity.

See Programs for more information.

Before you begin

Before creating a program, it's important to decide first on the best and most sensible way to structure your work streams. Think of the best way to fragment projects and teams into separate plans, and then consider what programs would make the most sense when you're viewing a collection of these plans.

When deciding on the best structure, remember the following considerations:

  • For a program to display information, it must have at least one plan added to it.
  • A plan can only exist in one program at a time, which means Plan A can only be added to Program 1. If you want to add Plan A to Program 2, you'll need to remove it from Program 1 first.

Depending on scale, here are some examples on how you can structure your work streams:

Example 1


  • You can use your program to represent your organization as a whole.
  • The plans in your program can then represent the work streams of individual departments that comprise your organization.
  • Note that depending on how your organization is scaling, this sample structure, where all departments are contained in a single program, may not be realistic. We recommend you consider some limitations when structuring your data in Portfolio for Jira. See example 2 below as an alternative structure for large scale organizations or large independent teams.

Example 2

  • You can also use your program to represent just one department in your organization.
  • The plans in your program can then represent the teams that comprise that department.

These structures of work streams for programs are just examples you can consider — you can even switch it up, and have your program as one department in your workplace, and the plans in the program as projects or boards.

The main point is to find the structure that works best for you, so you can capture all the information you need from your plans in Portfolio for Jira.

Creating a program

When creating a program, you can choose to add plans to the program later on. Note that a plan can only exist in one program at a time.

  1. In your Jira application, go to Portfolio (in header) > Create. The 'Create' page will be displayed.
  2. Select Create a program and click Create program.
  3. Give your program a name, and choose one of the privacy options:
    • No restrictions (default option) – every Portfolio for Jira user will be able to access the program
    • Private – only the creator of the program has view and edit permissions
    Note that if you select privateonly you will be able to see or access the program. The program will not be viewable by any other users, including Jira administrators and system administrators. If necessary, you can change the privacy option at any time.
  4. Select the plans you want to include in your program.
    If there are no available plans just yet, you can add them to the program you're creating later on.
  5. Click Create program.

Adding plans to a program

You can add plans to a program that doesn't have any plans yet, or add more plans to a program that already has plans.

  1. Go to your plan via Portfolio (in header) > View Portfolio > click your program.
  2. Click more () next to the program name > Configure > Connected plans.

  3. Select the checkboxes for the plans you want to add to the program.
    (info) To remove any plans from the program, clear the corresponding checkboxes.
  4. Click Save.

Deleting a program

When you delete a program, the plans in the program won't be deleted – but they will no longer be in any program. To use these plans in a different program, you'll need to add them to the other program.

  1. Go to your plan via Portfolio (in header) > View Portfolio > click your program.
  2. Click more () next to the program name > Delete.
  3. Click Delete to confirm deletion.

Related topics

Last modified on Jun 15, 2018

Was this helpful?

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