How to create and configure an Azure DevOps Work Items Link macro?

This macro allows you to embed a link to the Azure DevOps Work Items page directly within a Confluence page. This provides a convenient way for users to access information related to user stories, tasks, bugs, and other work items and navigate directly to the Work Item page in Azure DevOps.

Create Azure DevOps Work Items Link macro

Make sure the application is configured by your Confluence administrator first.

Here is the guide for the Confluence administrator.

We provide 2 convenient ways to create the Azure DevOps Releases Link macro:

1. Copy and Paste a link to Azure DevOps entities to the Confluence page directly.

2. Use the editor menu on the top (click on the + button) to reach the Azure DevOps Work Items Link macro. To make your search easier type the first letters of the macro name.

Example of links to Work Item

https://dev.azure.com/MoveWorkForward/Driverless%20Porsche/_workitems/edit/4/

Macro configuration

1. Enter the link to the Azure DevOps work item in the macro modal window.

2. The preview option allows you to verify and validate the macro view before actually inserting the macro into your Confluence page.

3. Tailor the macro display according to your specific needs and preferences. Here you can find the following options:

   1. hide/show header checkbox;

   2. selector of visible fields (in the Fields section’s drop-down are rendered fields based on the organization indicated in work item Url).

4. Click on the Safe button to insert the macro into your Confluence page.

View on the Confluence page

Updated: 12 May 2023