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.
- For team-level integration, go to Team settings > Apps & Integrations > Jira cards.
- For organization-level integration, go to Company settings > Apps > Manage apps > Jira cards > Settings.
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.
⚠️ While Atlassian has discontinued support for Jira Server as of February 2024, Miro will continue to support the Jira Cards integration for Jira Server for the foreseeable future.
- 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.
- For team-level integration, this information is available at Team settings > Apps & Integrations > Jira cards.
- For organization-level integration, this information is available at Company settings > Apps > Manage apps > Jira cards > Settings.
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
You can install Cards on the team level, or at the organization level. If you have multiple teams, then you can leverage organization-level settings to avoid repeating the setup procedure for each team. The existing Application Link is used for all teams.
After you connect your team or organization to a Jira instance, a new WebHook is created in your Jira WebHooks for that Miro team or organization. Creating a WebHook establishes a channel for update requests.
If you specify organization-level settings, teams that are already connected retain their current settings. However, they can switch to the organization-level settings at any time.
Additionally, if needed teams can override organization-level settings, in order to connect to a different Jira instance.
If you're an Enterprise customer who wants to migrate multiple team-level connections to the default organization-level connection, contact your account team.
⚠️ If you want to connect several teams separately, we recommend giving the webhook for each team a unique name. Go to your Jira WebHooks page and edit each newly created webhook.
Connecting several Jira instances to one Miro team is not supported.
Disabling the plugin
For team-level integration, go to Team Settings > Apps & Integrations > Jira Cards. Then select Remove for team.
For organization-level integration, to restrict Jira app usage, go to Company settings > Apps > Manage apps > Jira cards. Then move the toggle to the off position.
⚠️ If you disable Jira for the organization, then users from all Enterprise teams are unable to use Jira cards. To learn more about app management and restriction, see App management.
More information: See How to use Jira cards.