Azure Cards

Azure Cards allow you to import issues from Azure Boards (a part of Azure DevOps services, formerly VSTS - cloud solution) to your Miro boards. They can become essential to your remote retrospectives, story sizing, backlog prioritization, story mapping, and other team activities. You can also use them in Miro Kanban and User story mapping frameworks.

Miro UI updates in phased rollout
Miro is enhancing the board user interface to be more inclusive and intuitive, and introducing an evolution of Projects called Spaces. The rollout will occur gradually for all Miro accounts over several weeks.

 

In case you already have the enhanced UI and Spaces layout, this article may describe entry-points that have changed. 

 

To view the most current documentation, see Miro's new simplified user interface. 

 

This article will be updated when the rollout is complete.

Available for: Enterprise Plan
Set up by: Miro Company Admin & Organization owner in Azure Boards with Project Collection Admin group permissions; Miro Team Admin required for team-level connection.

Key features

• Import Azure Cards using the in-app Azure Boards work items picker. This includes various sorting options
• Search for Azure Boards work items in the in-app picker
• Automated easy-to-read card view changes while zooming in and out

✏️ Guarantee your Azure cards are always updated with card polling, which ensures users always get card updates even if webhooks fail. 

How to set up Azure Cards

Setup is required on two levels:

1. The app must be added to your whole organization for all teams, or added for specific teams.
2. On the personal level, integration must be connected and authorized by everyone importing Azure Cards.

✏️ In order to set up Azure Cards with Miro, the Azure admin and Miro admin must be the same account.

✏️ Please note that while adding Azure Cards requires Miro Team or Company Admin permissions and Azure organization owner permissions, these permissions can be downgraded after the connection is complete. The admin cannot be removed, however, and must retain access to the Azure project.    

How to add Azure Cards at the organization or team level

✏️ To connect Azure Cards at the team level, you must be a Team Admin.

1. Navigate to your Profile settings (click the main menu hamburger icon and choose Profile settings, or from the dashboard, click your avatar in the top-right corner and choose Settings)
2. Click Apps and then navigate to the Add apps tab on the right side.
3. Type "Azure Cards" and select it from the drop-down list. Click Add.
4. In the next dialogue box, choose either All teams or In specific teams, (choose your team if needed), then click Next step.
5. On the "Review and add Azure Cards" screen, click Add. The app will be added for your company or team.
6. Go to the Manage apps tab, search for Azure Cards, and click Approve. The app will now be approved at the company- or team-level.Adding the Azure Cards app to organizations in Miro
7. Next, connect your Azure organization to Miro. From the Apps panel, go to Manage Apps.
8. Search for "Azure Cards" in your apps list and click Settings.Azure Cards Settings
   
9. In the settings panel for Azure Cards, add your Azure instance url and click Connect. Provide your Microsoft Azure login credentials.Connecting your Azure organization to Miro
10. In the authorization dialog box, click Accept to finish connecting Azure to Miro.
    Authorizing the connection from Azure to Miro

How to apply specific Team-level settings

If you want to apply custom settings that differ from the global Company-level settings for specific teams, you can configure this in the Team Apps & Integrations area. 

1. From your profile settings page, click Teams.
2. Click the team to which you'd like to apply custom settings.
3. In the Teams panel, click Apps & Integrations. 
4. Find Azure Cards and click on it.
5. In the App settings panel, choose Apply custom settings from the drop-down at right, then connect the Azure account you'd like to have custom settings. 
6. Authorize Miro in Azure DevOps with your Microsoft account: click Connect next to "Microsoft account" and log in to your Microsoft account, allowing Miro to use it. 
7. Enter your Azure Organization URL (which can be copied from Azure DevOps) and click Connect. Miro will accept either your instance's personalized URL or the general https://dev.azure.com/ address ending with your instance's name.
   Adding custom Azure Cards settings to specific teams

How to add Azure Cards on the personal level

Each team member who would like to use Azure Cards must configure it at the personal level. This will personalize the сard picker and will allow importing all the Azure issues which the user can access.

After the Miro Admin installs the app, team users can see the Azure Cards icon on the Creation toolbar:

Azure Cards on the toolbar

1. Click the Azure Cards icon and a popup will ask you to Authorize.
2. Click the Authorize button and click Continue. You will be brought to Team settings > Apps & Integrations page.
3. Use the App Settings panel to connect your Microsoft account to Miro and specify the Azure instance you'd like to use. This can be copied from Azure DevOps, Miro will accept either your instance's personalized URL or the general https://dev.azure.com/ address ending with your instance's name.

✏️ Please note that only Team Admins can set up the configuration. If you do not get the Connect button, please make sure to grant yourself Team Admin rights for the team.

How to uninstall Azure Cards

Uninstalling Azure Cards at the team level requires Team Admin permissions.

1. Go to Team settings > Apps & Integrations > Azure Cards.
2. Scroll down and click Uninstall for team.
3. To uninstall Azure Cards on the personal level click Uninstall for me.

Uninstall the app for the whole team or for you only

Importing Azure Cards to Miro

Once you configure the app, you can import Azure Cards to any Miro boards with connected teams. Click on the Azure Cards icon on the toolbar to open the picker:

Azure Cards picker

We support search across all fields so you can easily find a needed card using its title, type, state, etc. It's also possible to use robust keyword search powered by Microsoft.

Search Azure Cards in the picker

You can filter cards by project, assignee, type, area, and state, which unlocks advanced filtering of Azure work items in the Miro in-app picker for users.

Filter Azure Cards in the picker

You can go to the card source item by clicking the Source button when you select a card.

The card's source button

Azure Cards can be used as both board widgets and as components of interactive Kanban and User Story Map frameworks. You can add Azure Cards to the interactive frameworks by dragging them in.

Working with Azure Cards in Kanban

Creating and editing Azure Cards in Miro

The two-way integration between Miro and Azure DevOps lets teams create and edit Azure cards right from a Miro board. You can also turn sticky notes and Miro cards into Azure cards.

To create an Azure Card:

1. Select Azure Cards from the Creation toolbar and choose Create work item on the top-right of the picker.
2. Fill out the card fields, choose a project, item type, assignee, and click Create. The new item will get created in your Azure DevOps directory as well.

Creating an Azure Card in Miro

To convert a sticky note or a card into an Azure Card:

1. Select the option on the sticky’s/card’s context menu.
2. Set the card parameters and click Convert. The text on the sticky note/card will be converted into the card title.

💡 Save time by bulk converting stickies or Miro cards to Azure Cards. Click and drag to select all objects you wish to convert, and within the context menu, select Convert to Azure work items. 

Converting a sticky note into an Azure Card

The option to edit Azure Cards in Miro removes the hassle of switching between the tools. To edit a card:

1. Click the Azure Card, and click the pen icon (edit) on the card’s context menu. A pop-up window will open, allowing you to edit the item’s fields.
2. Click Update to save the changes. The changes will be reflected in Azure as well.

The option to edit an Azure Card in Miro

Changing a card's color

To change a card's fill color, click the card or cards and choose fill color from the context menu. If you duplicate the card or cards, all subsequent copies will have the same fill color. 

Supported fields

• Title
• Project
• Type
• State
• Description (Edit is not supported)
• Parent WI
• Assignee
• Priority
• Story Points
• Area
• Iteration
• Acceptance Criteria

Custom fields are not supported.

Possible issues with Azure Cards and how to resolve them

Frequently asked questions