How to setup Azure DevOps integration with Confluence Cloud
In this guide, you will find instructions on setting up Azure DevOps integration for your Confluence instance at the space (for a specific Confluence space) or global (for the entire Confluence instance) levels.
In addition to space-level and global-level configurations managed by admins, the Azure DevOps Confluence Connector now supports personal settings. Confluence users can now independently connect their personal Azure DevOps accounts to render Azure DevOps macros without requiring admin setup.
How to connect personal Azure DevOps account for integration setup?
Create personal access token (PAT)
How to create Microsoft Azure DevOps personal access token
Set up Azure DevOps integration
Space configurations override the global ones.
Personal configurations override space and global configurations.
To set up Azure DevOps integration with a concrete Confluence space or on a global level, please follow these steps.
Start with the Integrate with Azure DevOps button.
When you create the new Azure DevOps integration, insert your read-only Azure DevOps PAT
Don’t forget to enter your Azure DevOps domain. For the SaaS offering from Microsoft please use https://dev.azure.com
You can enter the organization name if you want to:
Limit integration access to one particular organisation if PAT is created with all organisation's access;
When PAT provides access to only one organisation ;
Leave empty if you use PAT which provides access to all organisations and wish to use all organisations for integration.
Enter the integration name that will help you find the right integration. It is used like a label.
Feel free to use the “Test connection“ functionality to ensure your PAT has the right access to the Azure DevOps work items you want to use it with.
When the configuration is saved you can configure the fields in the “Fields configurations“ tab.
Test connection
You can test your configuration by clicking the “Test connection“ button in the footer of the dialog.
Afterwards, the optional tester will check that you can access a particular project in the Azure DevOps organisation.
Click “Back to integration settings“ if you want to change the integration settings.
You can press “Save“ independently of the results of connectivity checks
Configure Azure DevOps work item display fields
In the “Fields configurations “ tab you can change the displayed work item fields. These configurations are used in work items and shared search query macro.
It is best to configure fields by inserting a real work item URL that helps to pull the available Azure DevOps work item fields and helps with the preview.
You can drag and drop fields in the Fields input to change their order.
If you are happy with the fields proposed you can save the settings by clicking the “Save“ button.
The field configuration is applied on Azure DevOps organization and Azure DevOps project level and it is not linked/related to a Confluence space. This implies that the same field configuration will be used where the work item is used.
This may look like this
Updated: