Jira Integration Setup
Vaibhav Devpura avatar
Written by Vaibhav Devpura
Updated over a week ago

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 > Connect

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.

Features <> Board mapping

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

Status and Issue type mapping

Once the connected features in Zeda.io to your Jira Board, the mapping needs to be set up 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

  3. The Issue importance in Jira with the Feature importance in Zeda.io

  4. Issue custom fields in Jira with the feature custom fields in Zeda.io.

Apart from just the integration with Jira, there are various places where this information is leveraged in the workspace. Some of them are:

  • Once the Jira ticket is mapped with a feature in Zeda, Jira Id will be available in the features list view across the feature.

  • Zeda.io fetches the epic and fix version along with the manual import and hourly sync, which can be used for fields for any feature on Zeda.io as well. These fields are available in the Details tab of a feature.

  • Tags defined in Jira are also imported and synced with the workspace feature created

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

Import

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

  1. To import Jira tickets, you can just navigate to the features dashboard after the Jira authentication is done.

  2. Click on the "Add Feature" dropdown and select "Import features from Jira".

  3. Select the respective Jira project, select the mapping for status, type & importance fields, and click next.

  4. This method will enable you to import all or only the specific issues relevant to your backlog by providing a JQL.

Zeda.io Feature <> Jira Issue sync

Once your JIRA board is connected with a project and you have saved the status, importance and 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 workspace, you can select and send to Jira to 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 feature 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

Did this answer your question?