This guide will walk you through how to connect Marker.io to Azure DevOps, allowing you to track website issues directly in your Azure DevOps projects with all the technical details captured automatically.
Set up an Azure DevOps Integration
Add a project
To get started, go to the Marker.io dashboard and Create a project.
Complete the project form by entering a :
Project name
The website where you wish to collect issues
Select your integration
Select the space within your integration where you wish to receive your issues.
Authorize Your Account
If it’s your first time connecting, you’ll be prompted to authorize Marker.io to access your Microsoft account.
Tip: Ensure that you have admin access to your Azure DevOps account and that third-party application access is enabled (explained below).
Configure forms
Marker.io automatically pulls in native Azure DevOps fields for your forms. Here’s how to customize:
Show/Hide Fields: Choose which fields should be visible or hidden.
Preset Field Values: Set default values like priority, so reporters don't have to fill them in.
Note: Members of your team will report through the Member Form, while Guests and Public Reporters will use the Guest Form. Learn more about these roles in our User Roles Guide.
Install widget
To start collecting issues, you need to add the Marker.io widget to your website. Here are your options:
Manual Installation (Recommended): Add the widget using our JavaScript code snippet.
Other Installation Methods:
Use our WordPress plugin.
Install via NPM package.
Send an installation request to your developer with one click.
Once installed, refresh your website and confirm that the widget is visible.
How it works
Reporting Issues
When someone finds a problem, they can submit it through the Marker.io widget on your website. This process is simple:
Reporter Experience:
Click the widget.
Annotate a screenshot (optional).
Fill out the issue form.
Marker.io automatically captures technical details like:
Page URL
Browser type
Screen size
Operating system
Keeping the form simple is ideal for non-technical reporters, but you can customize it based on your needs.
Reviewing Issues in Azure DevOps
Once an issue is submitted, it appears directly in your chosen Azure DevOps project. Along with the report, you'll receive all the captured technical data.
Communicate with reporters
If you need to follow up with the person who reported the issue:
Open the issue and click "Contact via Marker.io."
This brings you to the Issue Page, where you can have a conversation. Any updates you make here are synced automatically with Azure DevOps.
Synchronizing Issue Status
When you mark an issue as “Done” in Azure DevOps:
Marker.io will update the issue status to “Resolved.”
The reporter will receive an email letting them know the issue is complete.
FAQs
Authorize third-party application access in Azure DevOps
Before you can fully connect Marker.io with Azure DevOps, ensure third-party app access is enabled:
1. In your Azure DevOps dashboard, go to your Organization settings:
2. Under Security > Policies, enable third-party application access via OAuth.
Once this is done, you’re ready to integrate Marker.io with Azure DevOps.
What Permissions Do I Need to Connect Marker.io to Azure DevOps?
To communicate fully with the Azure API via webhooks, we recommend using an account with admin privileges. This is especially important for setting up webhooks for status sync above.
Is Marker.io secure?
We take your data and the security of our systems very seriously, using the most advanced security to connect with your account. See the latest version of our security policy at: https://marker.io/security.
Need Help?
If you have any questions, comments, or corrections, chat with us at the bottom right of our web page.