Overview

Gtmhub provides both Jira Cloud and Jira Server apps for enhancing your Jira experience. You can link your Jira items to Gtmhub OKRs by creating Tasks under an OKR. This way you represent the work that you're actually doing in Jira to support your OKR. The integration also keeps in sync the Jira issue status with the Gtmhub Task status.

This article demonstrates how to install the Gtmhub for Jira Cloud.


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 an active Jira account.


Installation

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


Configuration

To configure Jira, perform the following:

  1. In Gtmhub, 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 you Jira account.
  2. Click on Settings and select Apps
  3. Click on the Gtmhub Addon option in the left-side navigation (located under the Other section)
  4. Configure the plugin with the details you copied from your Gtmhub account

NOTE: If you are getting a permissions error on the Gtmhub Addon configuration page, refer your Jira administrator to the Jira plugin permissions article for configuring the correct permissions set first.


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 Setup a Jira webhook.
This allow 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.

You can narrow down the list of objectives easily by searching for the objective's title, owner or description.

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?