Versions Compared

Old Version 1

changes.mady.by.user Weronika Spaleniak

Saved on

compared with

New Version Current

changes.mady.by.user Derya Özdemir

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Why should I display OKR data in Confluence?

Widgets added to your Confluence pages will allow you to share OKR status with coworkers with whom you work within Confluence and create OKR reports on Confluence pages.

How can I display my OKR data on a Confluence page?

...

Panel
panelIconIdatlassian-info
panelIcon:info:
panelIconText:info:
bgColor#F4F5F7

This page is about OKR for Jira Cloud. Using Data Center? Click here.

This document explains how to display your OKR data directly within Confluence pages using our OKR for Confluence app. It’s a free add-on that will allow you to add widgets with your OKR data to any Confluence page connected. This allows you to share progress, collaborate with colleagues, and create reports without leaving your familiar Confluence environment.

Benefits of Displaying OKR Data in Confluence:

  • Improved Collaboration: Share OKR status with teammates directly in Confluence, fostering communication and alignment.

  • Streamlined Reporting: Generate reports directly on Confluence pages, eliminating the need for separate documents.

  • Centralized Information: Keep all project-related information, including OKRs, accessible in one place.

Contents

Table of Contents
minLevel3
maxLevel6
outlinefalse
typelist
printablefalse

Prerequisites

  • You need to have a Confluence instance

...

Downloading the app

  1. Go to our marketplace page <add link>

  2. Click on the Get it now button

    Image Removed

  3. Wait until you get a notification that the app is installed.

...

  • .

  • You must have permission to manage settings in your Confluence.

  • OKR for Jira and OKR for Confluence should be installed in your Jira instance.

Installation

Step 1: Download the app

  1. Visit the OKR for Confluence marketplace page and click Get it now.

  2. Wait for the app installation notification.

Step 2: Establish a connection with your Jira instance

...

  1. In Confluence, go to Settings

...

  1. > OKR for Jira connection (Atlassian Marketplace section)

...

Check if the right Jira instance is prefilled on the page (the instance where you have the OKR app installed). Click on the “Link” button.

...

  1. .

  2. Verify the correct Jira instance and click Link.

    927e6601-8a48-4d0f-b9ed-d6eaaadd5aa9.pngImage Added

  3. A new tab with your Jira instance will open.

...

  1. Approve the connection in your Jira instance.

...

  1. 74db9b0d-f2a3-4890-b2d6-457ad38562ef.pngImage Added

  2. A new tab with your Confluence will open. It will inform you if the connection is established correctly.

...

  1. Image Added

  2. You can now close the tabs opened in

...

  1. Steps 3

...

  1. and 4.

Using macros on Confluence

Macro 1: OKR Live View

This macro enables you to showcase your live OKR for Jira data on a Confluence page, making it easy to share with your colleagues and create action lists, plans, etc.

Adding the macro:

  1. Open any Confluence page on the instance on which you’ve created the connection.

  2. There are two ways to add the OKR widget to your page:

    • Click the + icon in the top page menu and then search for the OKR live view macro.

      Screen Shot 2022-10-17 at 6.55.05 PM.pngImage Added

    • Type in “/okr” on your Confluence page and the widget should be suggested as an item to add.

      Screen Shot 2022-10-17 at 6.55.45 PM.pngImage Added

  3. After choosing the OKR live view macro, a setup dialog will appear.

    c2148b66-4e0b-41a8-b9b9-b60f61e33b86.pngImage Added

  4. Customize the view in any way you like. Set up the columns' width order, choose which columns should be visible, and how the view should be filtered and sorted. It works in the same way you’re used to in our Jira app, and it will be editable after you save the macro in the edit mode.

  5. Click Insert to add the macro to your page.

Your widget will look like this after saving the Confluence page:

8f6e62a1-b8b3-4b1a-bb39-e1f5c43a9b6c.pngImage Added

The view setup will not be directly editable, but you can go back to the edit mode by clicking the pencil icon. You can also select the widget’s width in one of the three options available below the widget.

The OKR data displayed on the widget is synchronized with your data in the OKR for Jira app.

Macro 2: OKR Report

This macro enables you to display frozen OKR for Jira data from the current date and time only. The displayed data will not be updated after adding the macro to the page.

Adding the macro:

  1. Open any Confluence page on the instance on which you’ve created the connection.

  2. There are two ways to add the OKR widget to your page:

    • Click the + icon in the top page menu and then search for the OKR report macro.

      Screen Shot 2022-10-17 at 6.55.05 PM.pngImage Added

    • Type in “/okr” on your Confluence page and the widget should be suggested as an item to add.

      Screen Shot 2022-10-17 at 6.55.45 PM.pngImage Added

  3. After choosing the OKR report macro, a setup dialog will appear.

    174a9914-8724-43f4-a6bb-c60c5f4c0ecf.pngImage Added

  4. Select a period from which you’d like to display the data. This period will not be editable after saving the widget, but the data will be filterable, so ensure that you can search for the right OKRs before saving the configuration.
    You can also view the date and time for when your report is created. Currently, we only allow the generation of reports using current data.

  5. Customize the view in any way you like. Set up the columns' width order, choose which columns should be visible, and how the view should be filtered and sorted. It works in the same way you’re used to in our Jira app, and it will be editable after you save the macro in the edit mode.

  6. Click Insert to add the macro to your page.

Your widget will look like this:

5c12916a-f9b5-4f8d-8efd-2e6abb88c7b1.pngImage Added

The view setup will not be directly editable, but you can go back to the edit mode by clicking the pencil icon. You can also select the widget’s width in one of the three options available below the widget.

We hope this documentation helps you effectively utilize our OKR for Confluence app to keep your team aligned and informed! For more information, please refer to our documentation or contact our support team.