Skip to main content
Skip table of contents

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:

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.