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.
Available for: Enterprise plan
Set up by: Miro Company Admin & Organization owner in Azure Boards
- 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
How to set up Azure Cards
Setup is required on two levels:
- The app must be added to your whole organization for all teams, or added for specific teams.
- 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
- 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)
- Click Apps and then navigate to the Add apps tab on the right side.
- Type "Azure Cards" and select it from the drop-down list. Click Add.
- In the next dialogue box, choose either All teams or In specific teams, (choose your team if needed), then click Next step.
- On the "Review and add Azure Cards" screen, click Add. The app will be added for your company or team.
- 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
- Next, connect your Azure organization to Miro. From the Apps panel, go to Manage Apps.
- Search for "Azure Cards" in your apps list and click Settings.Azure Cards Settings
- 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
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.
- From your profile settings page, click Teams.
- Click the team to which you'd like to apply custom settings.
- In the Teams panel, click Apps & Integrations.
- Find Azure Cards and click on it.
- 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.
- 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.
- 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
- Click the Azure Cards icon and a popup will ask you to Authorize.
- Click the Authorize button and click Continue. You will be brought to Team settings > Apps & Integrations page.
- 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.
- Go to Team settings > Apps & Integrations > Azure Cards.
- Scroll down and click Uninstall for team.
- 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
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:
- Select Azure Cards from the Creation toolbar and choose Create work item on the top-right of the picker.
- 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:
- Select the option on the sticky’s/card’s context menu.
- Set the card parameters and click Convert. The text on the sticky note/card will be converted into the card title.
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:
- 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.
- 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.
- Description (Edit is not supported)
- Parent WI
- Story Points
- Acceptance Criteria
Custom fields are not supported.
Possible issues with Azure Cards and how to resolve them
- Please make the necessary changes to your firewall and VPN configuration, adding our domains to your allowlist miro.com*, *.miro.com,mirostatic.com*, *.mirostatic.comandrealtimeboard.com*, *.realtimeboard.com, *static.miro-apps.com domains. If you use a proxy, please configure a reverse one allowing us access. Be sure to fill in the Azure DevOps URL field in the settings with the address that we can access (the address may differ from the actual address of your restricted Azure DevOps). You may also want to prolong the timeout value on your proxy server.
- All requests for the integration go through an Amazon load balancer, so providing specific network information isn't possible from Miro.
- Create service hook subscription ("vso.serviceendpoint_manage" scope required)
- Receive metadata about projects (this information is used to specify work items in subscription events correctly)
- The following methods are also required to be accessible to all users using the integration.
Frequently asked questions