Jira Integration

Connect your Zeda.io workspace with your JIRA project to collaborate seamlessly with engineering teams.

In this article

Introduction

Jira is a software development product for agile teams and is used to manage engineering backlog and sprints.

The Jira <> Zeda.io integration enables product teams and product managers to collaborate efficiently with the engineering teams by passing on epics, user stories or issues directly to a Jira board from a Zeda.io workspace.

Integration actions

  1. Forward features created in Zeda.io to JIRA and create Epics, Issues, Tasks or Bugs in the linked Jira board.
  2. Sync updates on Jira tickets like status changes, issue assignment, due dates with linked Zeda.io features to track development and release status within your Zeda.io product space.
  3. While setting up your Zeda.io workspace for the first time, import your product backlog from Jira.

Setup

To set up the Jira <> Zeda.io integration, you need to first authenticate your JIRA project in your Zeda.io workspace.

This can be done from Workspace Settings > Integrations > Jira or directly from one of your feature boards in Zeda.io

Workspace Settings > Integrations > Jira

Product > Features > Jira

Authentication

Authenticate your Jira Project with your Zeda.io workspace by entering the following details

  • Jira URL - This is the URL of your Jira project and is usually something like - https://{your_domain_name}.atlassian.net/
  • Username - This is your own Jira username
  • API Token - To generate an API token, refer to this document.

Product <> Board mapping

While setting up the Jira integration, you would need to map individual products in Zeda.io workspace to same or different boards in Jira for enable the product managers to collaborate with different engineering PODs for developing products.

Status and Issue type mapping

Once the connected products in Zeda.io to your Jira Board, the mapping needs to be setup for -

  1. The Issue status in Jira with the Feature status in Zeda.io
  2. The Issue type in Jira with the Feature type in Zeda.io

Screenshot 2022-01-15 at 12.33.36 PM

The Status and Issue type mapping will enable you to pass on Epics, Stories, Bugs, and Tasks to Jira as per your team conventions.

Import

While setting up your products in Zeda.io for the first time, you can import your product backlog if it is present in your Jira board seamlessly for efficient backlog management.

There are two ways to import your product backlog from JIRA -

  1. Import all Jira Issues - This method will enable you to import all the JIRA issues present in the connected board.
  2. Import specific Jira Issues only - This method will enable you to import only the specific issues relevant to your product backlog by providing a JQL

Screenshot 2022-01-15 at 12.33.55 PM

Zeda.io Feature <> Jira Issue sync

Once your JIRA board is connected with a project and you have saved the status, type mapping, the sync between the features within your Zeda.io product and JIRA board will start. This sync will ensure -

  • Any new feature created in your Zeda.io product will automatically create a new Issue in the linked Jira board with details like title, description, creator name, attachments and labels
  • Any update on a linked Jira feature like changes to status, title, description, type, attachments and labels will automatically reflect on the linked feature in your Zeda.io product.
  • Any update on a feature in Zeda.io will update the linked Jira issue.

Please note that as of now, the sync between Jira and Zeda.io is hourly for every product in your Zeda.io workspace. 

Pausing or revoking Jira Integration

At times, you may want to pause or revoke your integration to prevent the information transfer between one or all Zeda.io products and the connected JIRA boards.

  • To pause the sync for a specific product, navigate to Product > Features > Jira Integration > Pause integration
  • To pause the sync for all products in your Zeda.io workspace, navigate to Settings > Integrations > Jira > Revoke