Overview

Gtmhub provides both Jira Cloud and Jira Server apps for enhancing your Jira experience by integrating OKRs tracking in your JIRA issues.

This article provides information on how to install the Gtmhub app for JIRA Server. The app is called OKRs for Jira by Gtmhub.


Features

The application has the following features:

  • Tracking the progress of the linked Gtmhub Objectives in your Jira issues - Stories, Bugs, Features, Epics etc.
  • Tracking the Jira issues updates of summary, description, status, and assignees
  • Apply Jira issue updates to the linked Gtmhub tasks.
    A task in Gtmhub is an artifact that represents a unit of work that should be done to achieve an objective. Therefore, Jira issues are represented as a Gtmhub tasks. The app provides two-way synchronization between Jira issues and Gtmhub tasks.

Prerequisites

You must have a running Jira account.


Installation

In the Atlassian Marketplace, go to OKRs for Jira by Gtmhub and install it.


Configuration

To configure Jira, perform the following:

In Gtmhub:

  1. In the bottom of the navigation pane, click Settings.
  2. On the Configuration tab, click Jira.
  3. Use the Copy buttons to copy the values.

In Jira:

  1. Navigate to your Jira account.
  2. Click On Settings and select the Manage Apps option
  3. Select the Gtmhub Plugin Settings option from the left-side navigation
  4. Configure the plugin with the details you copied from your Gtmhub Account

NOTE: If you are seeing an error It seems that you do not have permission to view OKRs on the Gtmhub Plugin Settings page

Then you must configure the plugin permissions for specific Jira groups. Refer your Jira admin to the Jira plugin permissions article for more information on configuring the View OKRs permission.


Configure automatic Task status updates

When you link a Jira item to a Gtmhub OKR through this integration, this creates a Task under the specified OKR. The task is created with the current status of the Jira issue. If you want the Task to reflect the Jira issue status in real-time, you have to set up a Jira webhook.
This allows changes made in your Jira project to be automatically reflected in your Gtmhub account.
For more information, see Jira documentation > Webhook and Managing webhooks.

In the Jira webhook setup, paste the Webhook URL copied from Gtmhub.

In the Jira webhook setup, in the Events section, under Issues, select updated and deleted.


Use

Open a Jira issue and, from the Gtmhub OKRs panel, link it to a Gtmhub objective.

Afterwards, you are able to:

  • Follow the Gtmhub objective progress from within your Jira Cloud application
  • Follow the Jira issues progress from within your Gtmhub account.
Did this answer your question?