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 Miro on Jira
✏️ 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.
- Go to Jira Settings > Products > Integrations > Application links > Create link:
Note that the Jira interface may differ depending on your Jira version
- Choose Direct application link and enter https://miro.com/ in the Application URL field.
Important: you must enter the URL in this exact format. Click Continue.
Creating the link
- In the next menu, simply click Continue again.
- In the Review link menu, double-check that the URL is still exactly https://miro.com/ and enter the Application name of your choosing. Scroll down, and at the bottom, check the box Create incoming link. Skip the rest of the fields and click Continue.
Only the Application name field must be filled out
- Here you will see the fields for the Miro values. To get the values, log in to Miro and go to the team settings > Apps & Integrations > Jira cards.
If you do not have Jira Cards on your Apps list, scroll to the section's top, click Install apps, and proceed to install the app from Miro Marketplace. After you see the Jira Cards on the list, click to open it.
The plugin tab will open, and you can see Step 1 to get the values required:Jira Cards values
Copy the values and add them to the Atlassian Review Link menu. - You will see the processing message for a moment or two:
The last step of the link creation
This completes the steps on the Atlassian side. The link will appear on the list of your Application links.
Step 2 - Connection
Go back to your Jira Card Settings in Miro, and choose one of the two options: create a webhook manually or automatically. If you choose manually, uncheck 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 URL of your Jira instance. 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.
⚠️ Please note that Jira Server is being discontinued as of February 2024. The steps below will work similarly with Jira Data Center, however.
- Go to https://your-jira-server/plugins/servlet/applinks/listApplicationLinks. If "Application links" is not selected, click it.
Jira Server Application links
- Click Create link. Select "Atlassian product" and provide the Application URL, "https://miro.com". Click Continue.
Configuring the Application URL
- You will be taken to the "Link applications" dialog box. Add an Application Name (i.e. Miro Jira Card), and select "Generic Application" for Application Type.
You should see your Jira Application URL under "You are creating a link from:", and you should see https://miro.com under "To this application:". Click Continue.Configuring Link applications details
- The link configuration will process. When it finishes, you will see your new link in the "Application links" area of Jira Server.
Your configured application in Jira Server
- Next, you'll need to configure your application details. Click the pencil icon for your application to edit the application details.
- In the Configure dialog box, click the Incoming authentication option. Fill in the Consumer Key, Consumer Name, Public Key, and optionally a description. This information is found in Miro in your Team settings under Apps & integrations.
Configuring incoming authentication details in Jira Server
Jira application link details in Miro
- Scroll to the end of the Incoming authentication options and click Save. Your verification status should now be confirmed, and this Jira Server can now be used within Miro for use with Jira Cards. Be sure to choose "Jira Server" and "OAuth 1.0" on the Miro side.
User authorization
After the integration is connected, 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 end-users try 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)
Note that the Cards are installed on the team level, so if you are using our Enterprise plan, and have several teams you will need to repeat Step 2 for each of the teams that you wish to have connected. The existing Application link will be used for all of them.
After you connect your team to a Jira instance, in your Jira WebHooks a new WebHook is created - for the particular Miro team to which you made a connection. Creating a WebHook is to establish the channel for the update requests.
⚠️ If you plan to connect several teams, we strongly recommend going to your Jira WebHooks page and editing each newly created WebHook to have a unique name; otherwise, there might be confusion.
Connecting several Jira instances to one Miro team is not supported.
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!