Jira Integration

Jira Integration

If you’re already using both Jira and Chisel, Chisel’s Jira integration is the perfect tool to ensure that work items are synchronized between the two platforms.

Authorizing Jira Integration With OAuth2

When setting up an integration between Chisel and Jira, the first step is to authorize the integration between both the platforms with OAuth2. 

Follow the steps below to authorize the Jira integration with OAuth2.

  • Head to the integration section under the ‘User Actions’ tab. To do so, click on your name in the top right corner of the screen and click on ‘Integrations.’
  • Once you click on ‘Integrations,’ you will see a screen that shows you all the integrations you have set up and other integrations you can set up.
  • Next, click on the connect button next to Jira.


  • If you are already logged into Jira, you will be brought to a screen where you can see all the authorization-related access and Chisel requests for the Jira Integration.

    Scroll down and kindly accept the authorization by clicking on the ‘Accept’ button.
    Pro Tip: If you are not logged into Jira, kindly log in and follow the above step.
  • Now you will be navigated back to your Chisel workspace, where you will configure the integration as per your requirements.

Standard Configurations

Now that you have authorized the integration, you will have to configure the integration.

Follow the below three steps for standard configuration.

Choose Jira Project

The first step for configuring the Jira integration is to choose the correct Jira project.

Kindly choose the Jira project you want to integrate with Chisel and click on ‘Save Project.’

Two-way Sync

Two-way synchronization enables information to flow back and forth between Chisel and Jira.

Information like name, description, status, and timeline data when changed in Jira, would be reflected in your Chisel workspace and vice versa.

To enable two-way sync, Kindly enable the toggle below the 2-way Sync.

Automatic Import From Jira

Enabling Automatic Import from Jira would help you automatically import issues from Jira to your Chisel workspace.

To enable Automatic Import of features from Jira, kindly enable the toggle below the Automatic Import from Jira.

If you choose to enable automatic import, you will have to configure ‘Destination’ and ‘Issues types’ as mentioned below –

  • Under ‘Choose Destination – Product’, select the Product from your Chisel workspace where you want the imported components to be created.
  • Under ‘Choose Destination – Component’, select the Component from your Chisel workspace where you want the imported features to be created.
  • Under ‘Choose Issue Type – Import as a Component’, select the issue types (part of the Jira workspace) from the list which you want to be imported as Components in your Chisel workspace.
  • Under ‘Choose Issue Type – Import as a Feature’, Select the issue types (part of the Jira workspace) from the list which you want to be imported as Features in your Chisel workspace.

Jira – Chisel Mappings

The next step in the Jira integration is to map different entities between Jira and Chisel as nomenclature may differ between your Chisel workspace and Jira project.

Default Mappings

By default, the name, description, start date and due date will be mapped automatically

Status Mappings

The status from the Jira project and kanban status from Chisel needs to be mapped so that both stay in sync with each other.


For status mapping, you need to map every status from Jira with a kanban status in Chisel.

Label Mappings

The labels created in Chisel and Jira need to be mapped so that both stay in sync with each other.
For label mapping, you need to map every label from Jira with a label in Chisel.

After completing the above steps, kindly verify all the inputs you gave and click on Save Integration.

One Time Import

Apart from automatic import, Chisel also allows you to import the issues which are already in your Jira project to your Chisel workspace.

Select the Issue Types which you want to import in Chisel workspace, rewrite the JQL query in case required and hit ‘Find Issues’ button.

The section below will show you all the issues present in your Jira project fulfilling the JQL query you put.

Now you can choose to Import it as a Feature or as a Component. You can toggle between Feature and Component as per your requirement.

Import as Feature

If you choose to import it as Features, kindly select the Component from your Chisel workspace where you want the imported features to be created.

Import as Component

If you choose to import it as Components, kindly select the Product from your Chisel workspace where you want the imported components to be created.