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 - Application link
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 version 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 - Connection
Go back to Miro, and 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 base link of your Jira Dashboard page:
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 have connected your Jira instance to your Miro team. In your Jira WebHooks a new WebHook was created - for the particular Miro team to which you made a connection. If you plan to connect several teams, we recommend going to your Jira WebHooks page and editing each newly created WebHook to have a unique name otherwise, there might be confusion.
Creating a WebHook is to establish the channel for the update requests. After this, each of your end-users needs to connect their personal Jira profile to establish the proper permissions - this ensures that each user's access on the Miro end is exactly the same as on the end of your Jira instance. When an end-user tries to import or edit a Jira Card for the first time, they will be asked to log in to Jira using their individual user credentials.
After that is done, the users can add tasks as cards on the whiteboard. All the changes made in Jira are reflected in Jira Cards on the board.
✏️ If a user doesn’t have Jira credentials and the user has access to the board on which the card was added, they will see the card title, issue type, priority, assignee, and all attributes that are configured to be shown on the Jira Card. However, they won’t be able to expand the card to see other attributes and edit it unless they authorize. If the user doesn’t connect their Jira credentials, they will not see the assignee avatar and the general look of the card will be different.
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 Team 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!