Jira Cards

Available on: Team, Business, Consultant, Education and Enterprise plans;
Jira Cloud, Jira Server (On-Premise) and Datacenter
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. 

If you need to share our integration's specifics with your security officer or your compliance team please use this document.

✏️ Starting August 26, 2021 end-users have the option to connect individual Jira user credentials to use the integration, and starting from January 18, 2022, it will be the default and the only available setup for Jira Cards. Learn more: Authenticating Jira Cards in Miro with Individual User Credentials.

In this article:

1. How to use Jira сards
   1.1 Importing Jira cards
   1.2 Creating Jira cards
   1.3 Editing cards
   1.4 Adding custom fields to Jira Cards
2. Search options, JQL search

💡 Learn more about Jira Cards in these articles:

• Jira Cards FAQ
• How to Set Up and to Uninstall Jira Cards
• How to Set Up WebHook for Jira Cards
• Possible Issues with Jira Cards and Jira Add-on

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.

✏️ Depending on your account setup, on the picker, you will either see the Jira issues that your Jira admin has access to or will be prompted to log in with your individual credentials and will see the issues that you have access to. Admins can enable using individual user credentials, use this guide: Authenticating Jira Cards in Miro with Individual User Credentials.

Jira Cards menu

The size of a card depends on the summary of the issue and the number of the shown fields.

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 fields 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

⚠️ During the conversion tags and Due Date (available on Miro Cards) will be lost. Assignee will need to be set anew.

Editing Jira cards

Editing Jira cards is not supported in the Miro Desktop app, Mobile app and Tablet app.

There are 2 simple ways you can edit Jira cards.

The first option:

1. Choose the card you would like to edit and either double-click it or click on the Edit icon:
   
   Edit button
   
   
2. 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
   

The second option:

1. To edit the Jira card please select a card and click the Source button.
   
   Editing a Jira card

2. 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.

Adding custom fields to Jira Cards

Use our in-app Jira picker to set up custom fields like estimates, tags, sprints, and many others for Jira Cards you use on Miro boards. To select fields to display on cards click Jira > Configure card fields:

Choosing fields to display on cards on the board

⚠️ Please note that the Jira fields may vary from board to board as the settings are applied to the current board only. The default fields can not be removed from the picker and from the cards (Assignee, Issue type, Priority, Status) but you can always reset settings to default if you don't want additional fields to be added to the card.

✏️ If some fields are not displayed on the board after you chose them in the picker, it means that:

• a field doesn't have a value to be displayed on the board; 
• this field is not available for the issue type (e.g. Epic name field is available to Epic issue type only).

✏️ If you can't find a field on the card fields list, it means that:

• that kind of field is not supported by Miro (e.g. color custom field);
• the field is not associated with your Jira instance. Please see this Atlassian article for more information. Please also check out this advice article.

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 instructions on how to build JQL queries, please see this Atlassian article.

JQL search

 If you have a question about the internal workings of the integration, please check out this FAQ article.