We currently support all JIRA and JIRA Service Desk cloud accounts. If you run a self-hosted (on-prem) JIRA account, please contact us first. Depending on your setup, our integration may still work.

Also, if you have a large number of projects or a significant amount of historical tickets in your JIRA projects, we recommend creating a user to connect with that has access only to the projects that you plan to use.

Connecting to JIRA

From the JIRA integration page, enter your existing JIRA credentials.Once the connection is established, Notion will start fetching your data. This process may take a few minutes. You'll get an email once your JIRA data is ready for you and then you can choose the type of recipe you want to create.

Create a JIRA recipe

There are two ways to display your data from JIRA in your Notion Dashboard: Using the custom JQL Query or by setting up one of the JIRA Template Recipes.

Custom JQL query

JQL stands for JIRA Query Language, and it's a flexible way to search for issues in JIRA. JQL is very similar to SQL, and the advanced search box in JIRA provides with code suggestions and inline validation to make constructing queries easy.

Not familiar with SQL? No worries, you can use the simple search instead. With Simple search, you only need to fill in a set of forms. Once you have made your selection, click on the "advanced search" and your JQL query will be there, ready for you!

Paste the JQL query from JIRA into your Notion recipe to start tracking custom JIRA data.

Give your recipe a name that makes it clear to everyone on your team what you are tracking. You can also include a brief description to help your team understand why you are tracking this.

Finally, add the recipe to an existing dashboard or create a new one. You don't have to set a timeframe here. By default the recipe is set to display daily values, and will update daily from JIRA. If you want to choose a different frequency, create a JIRA Template Recipe.

JIRA template recipes

You can also choose one of the JIRA template recipes, which are pre-built formulas calculated by Notion to help you turn your data into actionable metrics.

Cycle Times by Issue Status

This recipe shows the average time (in days) that tickets spend in each status.

Add this to your dashboard to identify bottlenecks or trouble areas in your development team workflow. This helps to reduce disruption and the impact on efficiency, quality, and value.

Step 1: Recipe Settings

Each recipe template can be customized with a name and description to help your team understand why you are tracking this metric and what the data means.

Next, select the project you wish to pull data from. All your JIRA projects (include JIRA Service Desk projects) associated with your account will be listed in the Recipe template, though you can currently choose one at a time.

Finally, select the frequency (how often you want the value reported) for your metric. Values will update automatically based on the selected frequency.

Step 2: Template Settings

First, select all of the issue types you are interested in tracking. The calculated value will be the average time of all selected issues.

Second, select the issue states. A separate line will be displayed to represent the average time spent in each status selected.

Step 3: Addition Options

If you use additional fields in JIRA—like labels and priorities—you can also use these to filter your data set. Check a box to expand the options.

Once you have finished with the setup, you can add this Recipe to a dashboard or create a new one.

Cycle Times by Issue Type

This recipe shows the average time (in days) that it takes tickets to move between two states.

Add this to your dashboard to measure productivity and consistency of ticket types moving through a your workflow. For example, if the cycle time for features (the time it takes to finish a ticket) is increasing each sprint, perhaps you need to break tickets down into smaller pieces.

Step 1: Recipe Settings

Each recipe template can be customized with a name and description to help your team understand why you are tracking this metric and what the data means.

Next, select the project you wish to pull data from. All your JIRA projects (include JIRA Service Desk projects) associated with your account will be listed in the Recipe template, though you can currently choose one at a time.

Finally, select the frequency (how often you want the value reported) for your metric. Values will update automatically based on the selected frequency.

Step 2: Template Settings

First, select all of the issue types you are interested in tracking. A separate line will be displayed for each issue type selected.

Second, select the starting and ending boundaries of your cycle time. For example, you may be interested to know how long it took for tickets to move from Open to Closed.

Step 3: Addition Options

If you use additional fields in JIRA—like labels and priorities—you can also use these to filter your data set. Check a box to expand the options.

Once you have finished with the setup, you can add this Recipe to a dashboard or create a new one.