What can we help you with?

Jira Cloud Integration

Screen_Shot_2020-03-15_at_15.57.05.png

Need a way to manage tasks, issues, bugs in your Jira Cloud and monday.com? Now you can with our Jira integrated monday.com automations!

 

Add the integration

Step 1
 
To add an Integration, go to the board you want to create an Integration for and click on the Integration button, located on the upper right of your screen as below: 
 
integration.png
 
Once on the page, you will see all of the amazing apps we offer to integrate with, then go ahead and select "Jira": 

integrations.png

 

Step 2

From the list, select the recipe you want to add-

image_104__1_.png

Note: In the second recipe, updates to existing issues will sync to monday.com as well.
 

 

Step 3 

Connect your Jira account with the Jira token to monday.com. In the subdomain field, it's important to enter only the subdomain without ".atlassian.net" at the end. 

image_107.png

 
Note: To set up the integration, you will need to use the login credentials from a JIRA admin with global permission.

 

Create a Jira Token

  • Step 1

When in Jira, go to your avatar > "Profile":

Frame_146.png

Then, click on "Manage your account":

Frame_147.png

Next, click on "Security"

Frame_148.png

And select "Create and manage API tokens":

Frame_149.png

 

  • Step 2

Click on "Create API token":

Frame_150__1_.png

And enter a label name to create the token:

Frame_151.png

  • Step 3

Copy the token to enter into the automation setup within your monday.com account. It's that easy!  

 

Customize the integration

Once the token is added, you can customize your recipe any way you want with the applicable fields. For example, when an issue is created or updated in a project in Jira, you can create an item on your board and sync future changes from Jira-

Jira_Sync_Future_Changes_2.gif

Note: In this integration recipe, updates to existing issues will sync to monday.com as well.
 

You can also set a reminder if you want to update your team members with a summary of an issue in your projects in Jira- 

JIRA_Reminder.gif

Note: The Jira integration will not work retroactively. It will pull in only new issues, epics, etc. created in Jira along with updates made to existing issues, epics, etc. To retroactively pull through issues, please use our Jira import

 

Pull in the assignee

Contact permissions

If you want to pull a person into the "Assignee" column on monday.com, you need to change Contact permissions in Jira to "Anyone" for each individual. To change the contact permissions, enter your Jira account, click on your avatar and choose "Account Settings":

Frame_959.png

Then, select "Profile and visibility":

Frame_960.png

Scroll down to "Contact" and next to your email address, choose "Anyone":

Frame_961.png

Populating the "Assignee" column

To properly populate the "Assignee" column, the email address for the individual on monday.com must be the same as the email address for the individual in Jira.

If the email address is not public in Jira, then the Jira display name will be used instead of the email address to find a match on monday.com for the "Assignee". For this to work, the display name on monday.com needs to be the same as the display name in Jira.

If there are two users with the same display name on monday.com and in Jira, the "Assignee" column will populate with both people.

 

 

Create a two-way sync

A two-way sync occurs when data is being both pushed from monday.com into Jira and pulled from Jira into monday.com. This makes it so that your data matches in both platforms and remains up-to-date.

To create a two-way sync, in addition to the recipe used in the first example: "When an issue is created in this project, create an item and sync future changes from Jira"

You'll need to set up the following recipe: "When an item is created or updated, create an issue in this project of this type with these fields, and sync all future changes from this board"

Frame_114.png

Choose the correct project. In this case, we're going to use "KB Iteration Planning" again. For the type, we're also going to choose "Task" again.

Frame_115.png

After choosing your project and type, select "these fields" to begin mapping. 

With this recipe, when we’re mapping, the fields to the left are Jira data fields rather than the names of your monday.com columns. Here you’re mapping monday.com columns into Jira. It’s the reverse of the set up we walked through earlier in this article.

Frame_116.png

Once you finish mapping and click the "Add To Board" button, your two-way sync is ready to go!

 

Note: In Jira, there are certain field types that are required for an issue type. For this recipe to work, the fields required in Jira for your chosen issue type must be mapped in your monday.com integration. If those required fields are left blank, the integration will not work. There will not be an error message to indicate that the integration hasn't worked. The Jira admin can set the required fields within Jira. 
 

 

Compatible Jira fields

Currently, the following fields are supported when mapping from Jira into monday.com:

From Jira > monday.com
  • issuekey
  • issuetype
  • project
  • string
  • priority
  • user
  • status
  • radio button
  • resolution
  • number
  • watches
  • datetime
  • date
  • progress
  • votes
  • time spent
  • story points
  • epic link
    • Note: If using "epic link (name)", please note that it is supported in all issue types excluding "epic" and "issue (any)". To get the "epic name" on "epic" issue types select "summary".
  • assignee
  • time spent
    • Note: If using "time spent", the associated data will only sync to monday.com after the task is marked as done in JIRA.
  • All Jira custom fields can be mapped into a status column in monday.com, as long as the custom field type is one that is supported (see above). 

 

The following fields are supported for mapping the integration from monday.com to Jira (the reverse of the above):

From monday.com > Jira
  • string
  • priority
  • radio button
  • number
  • datetime
  • date
  • assignee
    • Note: The monday.com people column isn't supported. A text or email column type can be used instead.
  • status
    • Note: Because Jira allows you to build a workflow that transitions between different statuses, not every change in monday.com will change your Jira issue's status. The changes that would affect the status in Jira are the changes that apply to the workflow in Jira. If you change the status in monday.com to a label that Jira can't interpret, then you will receive a notification that the change didn't affect your issue in Jira.

 
Note: At the moment, team-managed projects (formerly called "next-generation projects") are not supported. 

Frame_994.png

 

Compatible monday.com columns

For an overview of the monday.com columns that are currently supported when mapping from monday.com into Jira, open up the drop down and take a look at the table.

Is your monday.com column supported? Take a look at the table.
Column Supported?  Notes
People Yes  
Status Yes  
Formula No  
Timeline No  
Date Yes Date is supported, but time is not.
Time Tracking No  
Auto Number No  
Item ID No  
Phone Yes  
File  Yes  
Link to Item No  
Mirror No  
DropDown No  
Location No  
Email Yes  
Tags No  
Text Yes  
Progress No  
Link Yes
Numbers Yes  
Last Updated No  
World Clock No  
Country No  
Long Text Yes  
Checkbox Yes  
Vote No  
Rating Yes  
Creation Log No  
Week  No  
Updates Yes* Not a real time sync. It will only sync the original data.
Color Picker No   

 

How to delete a recipe

You can turn off and/or delete your integration recipe in the integration menu- 

Frame_83.png

You can also edit the integration and the Jira account you want to connect it to in case you change your mind later!

 

 

More assistance

If you need help building custom integrations, we also have an option for paid assistance through our network of certified monday.com partners. If you're interested, please fill out this form and someone will be in touch shortly!

 

If you have any questions, please reach out to our team by using our contact form. We're available 24/7 and happy to help!

Have more questions? Submit a request