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.
In this article:
- Configuring Jira and Miro
1.1 Using one Jira instance for several Miro Teams (optional) - Uninstalling the plugin
Configuring Jira and Miro
✏️ Previously, the Jira Cards integration was set up with the Jira Admin's credentials: as a result, the Admin's set of permissions in Jira applied to all Miro team members. On Miro's side, the users were able to see and access all Jira issues and Jira projects that the Admin had access to.
Currently, we are introducing a new way of setting up Jira Cards using individual credentials which gives access to a user's unique issues and limits their access to the admin-level activity.
If your integration was configured with a Jira Admin's set of credentials, learn how you can enforce individual end-user authentication: Authenticating Jira Cards in Miro with Individual User Credentials.
✏️ 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. Enter https://miro.com and click Create new link.
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.
Incoming Authentication window
To get the values, log in to Miro and go to the Account > Settings > Apps & Integrations > Installed Apps > 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 > Jira cards.
Jira cards in the list of your Team Plugins
If you do not have Jira Cards on your Apps list yet, scroll to the Apps section top and click Add a new App and proceed to confirm. After you see the Cards on the list, click Install.
The plugin tab will open and you can see Step 1 to get the values required for the authentication in Jira:
Jira plugin menu, Step 1
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:
Jira plugin page, Step 2
To get the Jira URL please copy the link of your 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 > Installed apps > Jira Cards and click Uninstall for team:
The enabled integration in the Integrations list
Then click Show settings and disable your webhook in Step2:
Disabling the Jira webhook saved in your team's settings
💡 Don't forget to take a look at the main article on how to use Jira cards!