Back To Overview

Getting Started

1. Installation


Agile Hive is an app for Jira Software and can be downloaded via the Atlassian Marketplace.

Try it for free for 30 days without limitations.

Atlassian Marketplace


  • Jira Software 8.4.0 or higher.
  • Confluence is technically optional but highly recommended for implementing SAFe in terms of content, such as Lean Business Cases, Epic Hypothesis Statements or PI Planning Overviews.


After installation

  • After the installation is complete, Agile Hive directs you to the "Settings" page.
  • Please set a user with administrative privileges and "Edit issue" and "Browse project" permissions on all Jira projects that will be used in the Agile Hive context.

Next step

Project Creation

2. Project Creation


Agile Hive provides preconfigured projects for all four SAFe levels. Easily create a project for every Team, Agile Release Train, Solution and Portfolio with the corresponding template.

Go to 'Projects → Create Project' and select the desired project template.

Matching boards are also created automatically by Agile Hive. Of course, you can adapt the delivered project configuration to your wishes.

If you want to use existing projects, please follow this link:

Use existing Projects

Example - Creating an Essential SAFe (Agile Release Train + Teams)

» Creating the Agile Release Train project

  1. Go to 'Projects → Create Project' and select the 'SAFe ART Project' template.
  2. Enter a project name (optionally adjust the project key and the project lead).
  3. Repeat those steps for all your Agile Release Trains.

» Creating the Team projects

  1. Go to 'Projects → Create Project' and select either the 'SAFe Scrum-Team Project' or the 'SAFe Kanban-Team Project' template.
  2. Enter a project name (optionally adjust the project key and the project lead).
  3. Repeat those steps for all your teams.

Next step

Project Hierarchy

3. Project Hierarchy


With the help of the Agile Hive Project Hierarchies, you can map the four SAFe levels (Portfolio, Large Solution, ART and Team) as well as the business units (Jira projects like an ART or team project) located therein.

The SAFe levels are represented as horizontal layers. The business units are shown as colored nodes within the layers.

Go to 'Administration → Manage Apps → Project Hierarchies' to configure the Agile Hive Project Hierarchies.

More Details

Example - Creating an Essential SAFe Project Hierarchy (Agile Release Train + Teams)

» Create the SAFe Layers

  1. If you have no layers yet, you will be prompted to: “Click here to add your first Layer”.
  2. Create the first Layer and name it "Agile Release Train" or "ART". In the column "SAFe level" please select "ART" from the dropdown.
  3. Create the second Layer and name it "Team". In the column "SAFe level" please select "Team" from the dropdown.
  4. Close the "Configure Layer" dialog.

» Map the SAFe Projects

  1. Click on the grey Layer "ART" (on the right side an area will slide open, showing the name of the layer and a Drop-Down menu titled Projects).
  2. Clicking on the drop-down, a list of all Jira projects is displayed. By typing a name or a key of a specific project, you filter the results.
  3. Choose a project. It will be displayed in a list under the drop-down, labeled “New”. This indicates, that this project will be assigned to the layer once you press Save.
  4. Repeat this process for the Layer "Team" until all teams are inserted and visible inside the view.

» Relate the SAFe Projects

  1. Select a project within the "ART" Layer in the hierarchy view. In the sidebar is a drop-down titled "Child Projects".

  2. Clicking on the drop-down, a list of all Jira projects is displayed. By typing a name or a key of a specific project, you filter the results. Choose a "Team" project.

  3. Repeat step 3 until all "Team" projects are inserted & finally press Save. The selected "ART" should now be connected to the first "Team" project with a grey line.

Define Shared Service Teams

Shared Services are teams that are not strictly limited to a single ART, but rather contribute with their work to multiple ARTs. Examples for these teams could be different IT teams, accounting, system administration etc.

Issues from Shared Service Teams can be linked via the Agile Hive Hierarchy Link (Child of / Parent of) to issues from ART projects and will be considered for ART reports, if the issue is planned within a PIs timeframe.

Mark a project as Shared Service Team

  1. open the "Shared Services" tab next to "SAFe Layers".
  2. From there, click on the "Shared Services" panel on the left.
  3. A sidebar on the right will appear, where you can select projects that are not already used within the SAFe project hierarchy.
  4. When you have selected all relevant projects, click on "Save". 

Remove a Shared Service Team

  1. Hovering over the project name will display a trash icon.
  2. Clicking it will mark the project to be deleted with a lozenge.
  3. Clicking on "Save" will remove the project from the list of Shared Services.

Automated Agile Hive Main Menu

The hierarchy is automatically displayed in a menu called Agile Hive and is accessible to all users (reload the current page if it is not visible it in the top navigation).

This means that users can conveniently access the various projects and immediately access the numerous Agile Hive views.

Next step

Optional Configuration

4. Optional Steps

Introduction - Custom Issue Types, Workflows, Screens & Links

Agile Hive does not take anything away from you or limit you, on the contrary, you retain full flexibility. You can adapt all Issue Types, Workflows and Screens to your needs. Only a few Agile Hive fields should be used here and there - that's it. Let's take a closer look.

Issue Types

The following applies to all Agile Hive projects and their issue types:

  • Every Issue Type is optional
  • Add as many Issue Types to every Agile Hive Scheme as you want
  • Every Issue Type can be renamed
  • Every Issue Type can be removed from the Agile Hive Schemes
  • Every Issue Type can use other icons
  • Every Issue Type can be deleted
    • If the Issue Type Objective or Risk haven been deleted & you want to use Objective or Risk again, simply create new issue types with the name ‘Objective’ or ‘Risk’ and Agile Hive automatically uses them
  • Only the Issue Types Objective & Risk are used for specific reports


The following applies to all Agile Hive projects and their workflows:

  • Use your own workflows or adapt those from Agile Hive. There are no restrictions.


The following applies to all Agile Hive projects and their screens:

  • Adjust the screens according to your wishes. Add any fields & sort them as you like.
  • We recommend keeping the Agile Hive fields in the various schemes in order to be able to view and edit important information directly in the issue.

Agile Hive Links

All Agile Hive Linktypes can be renamed.

The outward / inward link of the following links can be renamed:

  • Agile Hive Objective Link
  • Agile Hive Risk Link
  • Agile Hive Dependency Link
  • Agile Hive Hierarchy Link
  • Agile Hive Strategic Theme Link

Custom Epic Panel

The 'Custom Epic Panel' allows you to display issues from a higher SAFe level in the Epic Panel of a Jira board. This empowers users to use drag and drop to hierarchically link for example stories on team level to Features on ART level. 

The same procedure can also be used for other scenarios. For example, another board can be used exclusively for objectives. Instead of Features, the team's objectives could be displayed in the panel and thus enable a easy linking between team issues and team objectives.
Since these settings can be stored for each board individually, numerous use cases are possible and all unaffected boards continue to work with the standard Jira Epic Panel functionality.

Go to 'Administration → Manage Apps → Custom Epic Panel → Configuration' to configure the behaviour of Epic Panels in the desired Jira boards.

Example for all Teams of one ART

  1. Click on "Create new configuration"
  2. Enter as Panel Name "ART" or "Features"
  3. Enter as JQL: project = "Your Project" AND statusCategory != Done
  4. Enter all Team Boards of the specified ART
  5. Set the Link Type to "Agile Hive Link"
  6. Set the Link Direction to "Inward"
  7. Enter as Backlog Name "Backlog"
  8. Press Save

More Details


AutoPage creates, links & updates Confluence pages, page trees & the page content automatically through Jira. This functionality is mostly used to automize the creation of the 'Epic Hypothesis Statement', the WSJF documentation and the 'Lean Business Case'.

Numerous use cases are possible. Think of automated Sprint review & retrospective pages or Release documentation.

Go to 'Administration → Manage Apps → AutoPage → AutoPage Settings' to configure when Confluence pages should be created, linked & updated automatically through Jira.

Example for automated documentation of Epics

  1. Click on "Create new rule"
  2. Rule: As rule name enter "Epic Overview"
  3. Issue Event Types: Select as Issue Event Types "all events"
  4. JQL: Provide the following JQL: project = "Your Project" and issuetype = "Your Issue Type for Epics"
  5. Confluence Space: Provide the Confluence Space where the page should be created
  6. Confluence Template Page: Provide a Confluence Page, that will be used as a template
  7. Confluence Page: Choose a Confluence page as parent page
  8. Issue Link Name: Enter "Epic Overview"
  9. Press Save

More Details

Next step

Using Agile Hive

5. Getting Started


After the installation and configuration is complete (step 1 - 4), it is time to set up Planning Intervals (PIs), create issues & plan some work so that the reports and the other Agile Hive views can present the information.

Please ensure the following before you proceed:

  • Layers were created in the project hierarchies and each provided with the correct SAFe levels
  • Projects were created using the Agile Hive project templates
  • These projects were inserted into the correct layers of the project hierarchies according to their SAFe level
  • The projects were linked hierarchically

Note: Of course, further projects can be created at any time and inserted into the layers

Managing Planning Intervals (PIs)

With Agile Hive, PIs can be created per ART. The respective sprints / iterations are then automatically created in the teams.
The user who creates the PIs must have the "Manage Sprints" and "Browse Projects" permissions in all child projects of the respective ART.

Creating new PIs

  1. Open the desired ART project in which the PIs are to be created via the Agile Hive menu
  2. In the reports view click on the PI dropdown at the top right
  3. Click on "Create new PI"
  4. Fill in the fields of the PI dialog & click the Confirm button

Repeat the process for other PIs.

After creation, PIs can be selected in the dropdown at the top right. This means that every user can switch to past, future and current PIs in order to view the reports, Breakout Boards or ART Planning Boards of a specific PI.

Editing PIs

  1. Open the desired ART project in which the PIs should be edited via the Agile Hive menu
  2. In the reports view click on the PI dropdown at the top right & select the PI which should be edited
  3. Again click on the PI dropdown and click on "Edit PI"
  4. Make the desired changes & click the Confirm button

Note: Only future PIs can be edited

Deleting PIs

  1. Open the desired ART project in which the PIs should be deleted via the Agile Hive menu.
  2. In the reports view click on the PI dropdown at the top right & select the PI which should be deleted.
  3. Again click on the PI dropdown and click on "Delete selected PI".
  4. Select whether to delete all corresponding Sprints and click the "Permanently delete PI" button.

Note: All PIs including the current PI and past ones can be deleted. Be careful, this step can not be undone.

Issue Creation

Since no issues have been created yet, the reports can hardly show anything. If you just want to test Agile Hive or your configuration, it makes sense to create at least one issue in each project.

The following issues should be created in the respective projects for a Full SAFe configuration:

  • Portfolio Epic
  • Capability
  • Feature
  • Story

Furthermore we would like to create a Risk and an Objective in all projects of the teams, ARTs and solutions.

Issue Linking

Before we link the created issues with each other, let's take a look at the five Agile Hive links:

(1) Agile Hive Link

  • This link type links issues hierarchically, that are located on adjacent layers. (Most layers / SAFe levels cannot currently be skipped - only the Large Solution level can be skipped when linking Issues in Full SAFe Configurations.)
  • It consists of the two link directions "Parent of" and "Child of".
  • Purpose: aggregation of progress and statistics for all reports.

(2) Agile Hive Objective Link

  • This link type links Team Objectives to other planned issues of the same team.
  • You have to link an objective with at least one planned story so that the objective can be seen in the respective PI in the reports (this will be improved soon).
  • It consists of the two link directions "Belongs to Objective" and "Is Objective of".
  • Purpose: summation of the story points that contribute to the respective objective in the team report as well as progress display based on the completed story points.

(3) Agile Hive Risk Link

  • This link type links Risks to other issues, that will mitigate the risk.
  • It consists of the two link directions "Treats" and "Is treated by".
  • Purpose: Issues that mitigate a risk are automatically displayed in the Team / ART / Solution Reports.

(4) Agile Hive Dependency Link

  • This link type links issues to dependent issues.
  • It consists of the two link directions "requires" and "is required by".
  • Purpose: Visual dependencies in ART & Breakout boards.

(5) Agile Hive Strategic Theme Link

  • This link type links issues from your portfolio to your company's Strategic Themes.
  • It consists of the two link directions "belongs to Theme" and "is Theme of".
  • Purpose: Aggregates your Portfolio Epics to your company's strategy.

Let us link the created issues:

  1. Link the Portfolio Epic, Capability, Feature & Story hierarchically by starting with the Story and linking it to the Feature with the 'Child of' link. Then link the Feature with the Capability and the Capability with the Portfolio Epic, so that there is a strand across all levels. If the custom epic panel from the optional step 4 has been configured for the projects, the child issues can be linked to the parent issues in the respective Jira board using drag and drop.
  2. Link a Team Objective with a Story from the same team with the "Is Objective of" link.
  3. Link a Risk on Team Level to any other issue with the "is treated by" link.
  4. Link an issue that is dependent from any other issue with the "is required by" link.
  5. Link the Portfolio Epic to a Strategic Theme issue with the "belongs to Theme" link.

Of course, you can also create the links from the second issue. Make sure to use the correct link direction.

PI Planning

Now that we have made all the preparations, we can do the PI planning and bring the Agile Hive reports as well as the Team Breakout views and the ART boards to life.

Select a team from the Agile Hive menu. You are now in the Agile Hive Report for the selected team. Now you can easily switch to the Team Breakout Board and the ART Board using the buttons at the top left.


  • If the Breakout Board is opened from within a team, it is team-specific and represents the respective team in the first row. The capacity for this team can then be entered here.
  • If the Breakout board is opened via the ART project, the teams are displayed alphabetically and consequently no capacity can be entered.
  • The ART Planning Board is always displayed identically, regardless of which project it was opened from.
  • With the menu entries 'Zoom' and 'Issue Layout' you can change the size of the issues on the Breakout and Planning Board.

Breakout Board

Step 1 - Capacity

  • Enter the capacity for each sprint of your team

Step 2 - Assign Features

  • Open up the ART Backlog Sidebar and drag and drop the ART issues into your team. They will be displayed as swimlanes (Feature Lanes).

Step 3 - Feature Breakdown

  • Break down those ART issues into Stories (or any other team issue type) by hovering into a swimlane, clicking the '+Add' button & creating a new Story.
  • These issues are automatically linked hierarchically with the ART issue and are also scheduled in a sprint.

Step 4 - Dependencies

  • Dependencies are shown automatically for all issues that are linked with the Agile Hive Dependency Link (requires / is required by).

Learn More

ART Planning Board

The ART Planning Board is an automatically generated view and therefore no steps are required here.

  • The completion of features and other ART issues is calculated automatically with Agile Hive. The respective feature is thus represented in an iteration in which it is completed.
  • Dependencies that were set via the Agile Hive Dependency Link are displayed visually. In addition, all other planned issues are shown on which the ART issues depend.

Agile Hive Reports

Team Level

ART Level

Solution Level

This page was last edited on 05/21/2024.