Skip to main content
Skip table of contents

Get started guide for the Confluence end user

Get started guide for the end user of Microsoft Azure DevOps Confluence Cloud integration

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

Here is the guide for the Confluence administrator.

App usage

Microsoft Teams Azure DevOps Confluence Cloud integration support Azure DevOps instances in the cloud (dev.azure.com) and in your premises. For your instances, you must make sure they are accessible from the Internet.

Your Confluence administrator must add the domain used into the allowed domains on the Azure DevOps configuration page.

Microsoft Azure DevOps Confluence supports the following macro:

  • Provide rich information about Azure DevOps work items on the Confluence page.

  • Provide rich information about the results of Azure DevOps saved search queries. You can display only the result item count or the top N items.

  • Allow shown data configuration for work item-related macro.

There are 3 macros available:

Short Video Demo

Azure DevOps for work items

You need to make sure the Query/Work Item/Project can be accessed by the user who created the personal access token. See here how to make shared queries.

This macro aims to provide rich information about a single Azure Work Item.

Here is an example of how it looks.

Azure DevOps single work item macro examples

Azure DevOps Work Items Query for saved work item queries

You need to make sure the Query/Work Item/Project can be accessed by the user who created the personal access token. See here how to make shared queries.

This macro aims to provide rich information about the Azure Work Items returned by the Azure DevOps Work Item Query.

Here is an example of how it looks.

Azure DevOps wiki

Please make sure your personal access token (PAT) has the read scope for Wiki.

Using Azure DevOps Confluence Connector, you can embed wiki content.

Create or find the wiki page that you want to embed. Usually, it is a project readme or something similar.

Afterwards, use the Azure DevOps Wiki macro that brings wiki content from Azure DevOps wiki to Confluence Cloud.

Use cases

Please follow the use cases section for more details examples.

Examples

Integrate Azure DevOps with Jira

If you are looking at how to bring Azure DevOps commits, builds, branches and deployment information to the Jira issue screen - check out Azure DevOps for Jira Atlassian Marketplace application.

Updated:

JavaScript errors detected

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

If this problem persists, please contact our support.