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 or KRs 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 or a KR. 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 your Jira account.

  2. Click on Settings and select Apps

  3. Search for "Gtmhub for Jira Cloud" and install it.

  4. It is very important to configure the correct permissions set first.
    Refer your Jira administrator to the Jira plugin permissions article and follow the described steps.

  5. Configure the plugin with the details you copied from your Gtmhub account.


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 status changes made in your Jira project to be automatically reflected in your Gtmhub account.
For more information, see Jira documentation > Webhook and Managing webhooks.

Contact your Jira administrator to perform the following in Jira:

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 or KR.

You can narrow down the list of OKRs easily by searching for the Objective or KR title, owner or description.

Afterwards, you are able to:

  • Follow the Gtmhub OKR progress from within your Jira Cloud application

  • Follow the Jira issues progress from within your Gtmhub account.

Did this answer your question?