Skip to main content
Skip table of contents

Azure Devops Integration

You can create or link to existing issues directly from Matrix Requirements. Once linked, issues are tracked for changes so that you can see when they have been resolved. All users will see the ID and the title of the issues right in the Matrix Requirements items and can jump to Devops from the Matrix items.

Backlinks to Matrix are added as comment and hyperlink to the issue, giving you direct access to the Matrix items related to the issue.


Once the Devops integration is installed and you have enabled it in the Extensions settings you have to configure it for each Matrix project you want to use it on.

Before you do this you need a Private Access Token from Devops. To create this token follow the steps described in this Microsoft official documentation. Make sure you select "workitems read & right" custom scope. Register this token in a secure way.

Back in Matrix administration, enable the addon at the instance level:

then at each project level you need the feature:

  • Devops URL : the URL to get access to your Devops instance - Make sure there is no trailing slash in the URL !

  • Devops API token : the Private Access Token you created earlier

  • Devops projects name : use complete names (separated by a comma if multiple)

Quick search setup:

  • you can add multiple target projects following settings like

Don't forget to save the changes !

Using the integration

To test the setup, go to a Matrix item and press the Tools button at the top. You should see 2 new actions in the menu:

  • Create and link Devops task

  • Link to existing Devops task

The integration offers the following functionality from a Matrix item:

  • Create and link to Devops issues from Matrix

  • Link to existing Devops issues from Matrix (preventing to link twice the same issue)

  • Remove existing links

  • Show Devops issue status (open vs. closed) right in Matrix (after page reload)

  • Show Devops issue content (shift + over issue number)

Whenever you add / remove a link to a Devops issue, in the issue, you should see:

  • a new comment

  • an hyperlink (if link created) to the Matrix item

JavaScript errors detected

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

If this problem persists, please contact our support.