Skip to main content

Azure DevOps tests (branch)

Azure Devops (formerly VSO, VSTS) is Microsoft Azure's CI/CD platform.

To obtain your own badge, you need to get 3 pieces of information: ORGANIZATION, PROJECT, DEFINITION_ID.

First, you need to select your build definition and look at the url:

ORGANIZATION is after the dev.azure.com part, PROJECT is right after that, DEFINITION_ID is at the end after the id= part.

Your badge will then have the form: https://img.shields.io/azure-devops/tests/ORGANIZATION/PROJECT/DEFINITION_ID.svg.

Optionally, you can specify a named branch: https://img.shields.io/azure-devops/tests/ORGANIZATION/PROJECT/DEFINITION_ID/NAMED_BRANCH.svg.

You may change the "passed", "failed" and "skipped" text on this badge by supplying query parameters &passed_label=, &failed_label= and &skipped_label= respectively.

For example, if you want to use a different terminology:

?passed_label=good&failed_label=bad&skipped_label=n%2Fa

Or symbols:

?compact_message&passed_label=💃&failed_label=🤦‍♀️&skipped_label=🤷

There is also a &compact_message query parameter, which will default to displaying ✔, ✘ and ➟, separated by a horizontal bar |.

Path Parameters
organization string REQUIRED

Example: azuredevops-powershell

project string REQUIRED

Example: azuredevops-powershell

definitionId string REQUIRED

Example: 1

branch string REQUIRED

Example: master

Query Parameters
compact_message boolean
passed_label string

Example: good

failed_label string

Example: bad

skipped_label string

Example: n/a

style string

Possible values: [flat, flat-square, plastic, for-the-badge, social]

If not specified, the default style for this badge is "flat".

Example: flat

logo string

Icon slug from simple-icons. You can click the icon title on simple-icons to copy the slug or they can be found in the slugs.md file in the simple-icons repository. Further info.

Example: appveyor

logoColor string

The color of the logo (hex, rgb, rgba, hsl, hsla and css named colors supported). Supported for simple-icons logos but not for custom logos.

Example: violet

logoSize string

Make icons adaptively resize by setting auto. Useful for some wider logos like amd and amg. Supported for simple-icons logos but not for custom logos.

Example: auto

label string

Override the default left-hand-side text (URL-Encoding needed for spaces or special characters!)

Example: healthiness

labelColor string

Background color of the left part (hex, rgb, rgba, hsl, hsla and css named colors supported).

Example: abcdef

color string

Background color of the right part (hex, rgb, rgba, hsl, hsla and css named colors supported).

Example: fedcba

cacheSeconds string

HTTP cache lifetime (rules are applied to infer a default value on a per-badge basis, any values specified below the default will be ignored).

Example: 3600

link string[]

Specify what clicking on the left/right of a badge should do. Note that this only works when integrating your badge in an <object> HTML tag, but not an <img> tag or a markup language.