How to add a Microsoft Azure DevOps work item to a Confluence document?
The how-to guide on how to add a Microsoft Azure DevOps work item to a Confluence document?
Adding Azure DevOps work item macro
You need to ensure the Query/Work Item/Project can be accessed by the user who created the personal access token.
This macro aims to provide rich information about a single Microsoft Azure DevOps Work Item.
Here is an example of how it looks.
![](../__attachments/2383577089/image-20211216-114349.png?inst-v=8ed9d612-469d-42f2-91de-89125d175e22)
Azure DevOps single work item macro examples
To add a macro, you need to copy the work item URL first. Navigate to the work items or any other way to the work item you want to embed into the Confluence page.
![](../__attachments/2383577089/image-20230313-115152.png?inst-v=8ed9d612-469d-42f2-91de-89125d175e22)
Copy the URL; it should be in the format.
<BASE_URL>/<ORG>/<PROJECT>/_workitems/edit/<ID>/
If you are using Microsoft Azure DevOps running On-Premise, you need to make sure you are using the URL accessible from the Internet.
Start typing Azure and get the correct macro.
![](../__attachments/2383577089/image-20230313-115643.png?inst-v=8ed9d612-469d-42f2-91de-89125d175e22)
Updated: