Available for: Jira Cloud, Jira Server (On-Premise) and Datacenter (LDAP-protected too)
Set up by: Miro Team Admin & Jira System Admin with Project administrative permissions
⚠️ If any technical issues arise please refer to our article about Possible issues and how to resolve them.
💡 Learn more about Jira Cards in the articles Jira Cards FAQ and How to set up webHook for Jira Cards.
Configuring Jira and Miro
✏️ Please note that Jira menus may differ depending on the Jira version you are using however the general flow should be the same. The instructions below can be also found in Atlassian Support.
Step 1
First, create an application link and configure it.
1. Go to Jira Settings > Products > Integrations > Application links.
2. Click Create new link (if you're on a newer versions of Jira Cloud and Server - choose Atlassian product/Create an incoming link). Enter https://miro.com
Adding Miro site address to the Application links list
3. You will then see the following dialogue window. Double-check the URL or click Continue:
Configure Application URL window
4. In the Link applications window fill out Application name and Application type and click Continue.
Application name and Application type fields are required
You will see the message Application Link ‘Application name’ created successfully and it will appear on the list.
5. Now authenticate the application using your Miro data. In the appeared application click Edit:
The application link is now created and requires configuration
6. Open Incoming Authentication OAuth tab. Fill out four values: URL, Consumer Key, Consumer Name, Public Key. The values are the same for all Miro teams.
Incoming Authentication window
To get the values, log in to Miro and go to the team settings > Apps & Integrations > Jira cards.
Note that the Cards are installed on the team level, so if you are using our Enterprise plan you will need to choose one of your Company teams (you can connect several teams to the same Jira instance), like so: Company Settings > Teams. Choose a Team from the list and go to Apps & Integrations.
If you do not have Jira Cards on your Apps list yet, scroll to the Apps & Integrations section top, click Install apps, and proceed to install the app from Miro Marketplace. After you see the Jira Cards on the list, click it.
The plugin tab will open and you can see Step 1 to get the values required for the authentication in Jira:
Jira Cards values
Copy the Miro values, paste them into the Jira OAuth tab and hit Save. After Jira processes the values you will see the message that Miro is now authorized to process your Jira data, status Configured:
The successful configuration status
Step 2
Go back to Miro, open Jira cards app settings (Team settings > Apps & Integrations > Jira cards).
Choose one of the two options: create a webhook manually or automatically. Depending on your choice unsign the option. Please see more information in this article. We strongly recommend using the automatic webhook so you do not have to reset it in case of big updates to the plugin.
Finally, enter your Jira URL and click Connect:
Connecting Jira Cards
To get the Jira URL please copy the link of your Jira Dashboard:
Jira dashboard
We accept the following formats:
https://name.domain/
https://name.domain:port/
https://IPaddress/
https://IPaddress:port/
If your Jira URL is not accepted, please refer to this article. Please also check that Miro has enough access to your Jira to establish the connection.
Now you can add your tasks as cards on the whiteboard. All the changes made in Jira are reflected in Jira Cards on the board.
Using one Jira instance for several Miro Teams (optional)
If you have multiple Miro Teams you can use one existing Application link to sync Miro and Jira. Please install the Jira Cards app to any of your teams and then simply paste the Jira base URL to the integration settings of your other Miro teams and click Connect.
Uninstalling the plugin
Go to your Account Settings > Apps & Integrations > Jira Cards and disable your Jira URL under Step 2. Then click Uninstall for team.
Uninstall Jira Cards
💡 Don't forget to take a look at the main article on how to use Jira cards!