Azure Cards

Azure Cards allow you to import work items 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: Business plan, Enterprise plan
Set up by: Miro Company Admin & any user with Project Collection Admin group permissions in Azure Boards; 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 either on an organizational-level for all teams, or added on a team-level for specific teams.
2. After the app is added, the integration must be connected and authorized on a personal level to import 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 work items which the user can access.

After the Miro Admin installs the app, team users can see the Azure Cards icon on the Creation toolbar. If the icon isn't there, you may need to search for it:

1. In the Creation bar, select Tools, Media and Integrations (+).
   The Tools, Media and Integrations panel opens.
2. In the Tools tab, search and select Azure Cards.

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 work items to Miro

When you import an Azure work item to Miro, it automatically transforms into an Azure card for seamless integration and visualization. Once you configure the app, you can import Azure work items to any Miro boards with connected teams. There are two ways to import Azure work items to your board:

• Copy the Azure work item URL and paste it on the Miro board. 
• By using the Azure Card picker: 

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