Azure DevOps Connector for Confluence

How to create an Azure DevOps Wiki macro

This macro allows you to embed Azure DevOps Wiki pages within a Confluence page. This provides a convenient way for users to access Azure DevOps Wiki information directly from Confluence.


The Azure DevOps Wiki macro is available from version 5.17.26 onwards

Create Azure DevOps Wiki macro

For the Wiki macro to work, the following Personal Access Token permissions are required:
Build (Read); Code (Read)(required for images); Wiki (Read); Work Items (Read)

For more, see How to generate Azure DevOps Personal Access Token

There are two ways to access the Wiki macro.

  1. Start to type ‘{azure devops macro wiki’ in a Confluence page and then select Azure devops macro wiki from the suggestions list:

    image-20240906-233452.png


  2. Alternatively, use the editor menu on the top (click on the + button) and select Other macros at the bottom of the drop down list. From the pop up, search for and select the Azure devops macro wiki:

    image-20240906-235057.png

Insert the Azure DevOps Wiki URL

Copy the URL from the Azure DevOps Wiki and paste it in the link field. Clicking the image-20240907-001400.png button will provide a preview of what is shown in the published Confluence page.

image-20240907-001632.png


Troubleshooting

If you encounter a (No or invalid token - Configure) error message after the URL in the preview, this is likely due to incorrect permissions on the Personal Access Token.

image-20240907-003412.png


Updated: