Available for: Team, Business, Consultant and Company plans;
Available to: team members that are editors on the board
Jira Cards allow you to work with Jira issues right on the Miro boards. Go ahead and make them a part of collaborative retrospectives, story sizing, backlog prioritization, story mapping and other team activities. Want to learn how others use Jira Cards with Miro? Read our blog post.
Contents
- How to use Jira сards
1.1 Importing Jira cards
1.2 Creating Jira cards
1.3 Editing cards - Search options, JQL search
- Frequently Asked Questions
💡 Be sure to also check the article How to Set Up and to Uninstall Jira Cards.
How to use Jira cards
Importing Jira cards
There are two ways to import Jira cards to your board:
1. Copy the Jira issue URL and paste it on the board.
2. Open the three-dot menu on the main Toolbar > select Jira > pick one, several, or all issues on the page > click Add:
Jira Cards menu
The size of a card depends on the summary of the issue.
Jira Cards on the whiteboard
If a user does not belong to your Miro team, they will not see the assignee avatars and the general look of the card will be different:
The viewer is not a part of the board's team
Creating Jira cards
You can create Jira cards right from Miro. At the same time, an issue in Jira is created with all the card attributes are synced automatically.
There are two ways to create a Jira card from scratch on the board:
1. By creating a Jira card with the help of a picker: Click Add > Jira > Create issue. Fill out the required fields and click Create:
Creating a Jira card via the picker
2. By converting a sticky or a card into a Jira card. First, you will want to create a sticky, add the necessary text and then just click Convert to Jira issue on the edit bar:
Converting a sticky into a Jira card
Editing Jira cards
Please note that editing Jira cards is not supported in the Miro Desktop app.
There are 3 simple ways you can edit Jira cards:
1. Choose the card you would like to edit and click on the Edit icon:
Edit button
In the new pop-up window, you will see your Jira issue. To confirm your changes click Update at the end of the page and close the window.
Updating your Jira card
2. Double click on the Jira card.
In the new pop-up window, you will see your Jira issue. To confirm your changes click Update at the end of the page and close the window.
Double-clicking on the Jira card
3. To edit the Jira card please select a card and click the Source button.
You will be redirected to the Jira issue page in the next tab. After making changes in the Jira interface your Jira card will be updated automatically. Manual changes are displayed immediately. If you use a script or any other automated procedure to update your Jira issues, such changes may come with a slight delay.
Editing a Jira card
Search options, JQL search
When choosing an issue you will always see recent tasks first.
1. You can change the order of the tasks ranking them by:
• Issue type
• Priority
• Key
• Summary
• Assignee
• Status
2. The basic search allows you to find issues by keywords:
The search results show the tasks that contain the keywords
3. Advanced search allows you to build structured queries using the Jira Query Language (JQL). You can specify criteria that cannot be defined in the quick or basic searches. For an instruction on how to build JQL queries, please see this Atlassian article.
JQL search
Frequently Asked Questions
1. How does Jira-Miro authentication go exactly?
- The protocol used is OAuth 1.0. The flow/grant is Authorization Code grant type.
2. Is data secured in transit between Jira and Miro?
- We use the TLS security protocol. It encrypts HTTP messages before transmission and decrypts messages upon arrival.
3. Can we have a diagram showing the data flows between Jira and Miro, such as during authentication, normal usage, etc.?
- Detailed info can be found in this Jira Developers article. We implement our integration according to Atlassian documentation.
4. Is it possible to save search queries (using advanced search) in Miro?
- We are showing in a Jira picker the queries that are added to favourites in Jira by the user who set up the integration.