Skip to main content

How do I import my audit observations into Azure DevOps?

Once you’re done with your audit (congrats!) your sights will likely be set on what’s next, moving forward planning on remediating the observations found in the evaluation. We offer multiple options for exporting this data so you can import into any tool that fits your organizations structure. This article will focus on the process to export from Be Inclusive and import into an Azure DevOps project.

Exporting from Be Inclusive for Azure DevOps

All download options can be found at the top of the results page under the headline “Export & Share Options”, click on “Download All Observations as Azure DevOps Issues” to get a specially formatted CSV file that can be easily imported into an Azure DevOps project. Save that somewhere on your computer.

Five export links - 'Make Publicly Visible', 'Download All Observations as CSV', 'Download All Observations as Azure DevOps Issues', 'Download All Observations as Jira Issues', and 'Download All Observation Images'
Be Inclusive Export & Share options found in the Results page of a completed audit

Importing into an Azure DevOps Project

Great, you’ve got all your observations downloaded and ready to go! Now navigate to the Azure DevOps project you want to import them into, find the “Queries” button in the side navigation under Boards and click it.

A typical Queries board view, where we can bulk import observations
Azure DevOps Queries board

Regardless what your Queries page displays, there should be a button at the top of the page called “Import Work Items”, click on that for the import form illustrated below.

the 'Import Work Items' flyout form with a single field to upload a formatted CSV file.
Azure DevOps “Import Work Items” flyout

Upload the CSV you downloaded from your Audit results page, click the “Import” button at the bottom of the flyout. When it completes processing, you’ll be presented with a table of the items ready to be imported. Clicking on any of these items will open the details in a sidebar, from here you can make any modifications or additions you’d like.

the 'Import Work Items' verify step, a table of new work items imported from the CSV, to the right is a sidebar with details of the selected new work item open for edits before saving.
Azure DevOps “Import Work Items” verify step

When you’re satisfied with all the new work items, you can finish and save all of them by clicking the “Save Items” button at the top of the page. Please note that imported items are not stored until you do this!

Last updated: Oct 19th 2022

Have any feedback about this knowledge base article? Let us know!

Let us simplify your a11y audits

Register now and try it free for a week!

Let's get to work!