Skip to end of metadata
Go to start of metadata


Status badges and the Sauce Labs browser matrix widget help you keep track of the status of your latest test runs. All you have to do is add either markdown or HTML code to your GitHub README or project site that references your Sauce Labs username and access key, and annotate your tests with the REST API

Status Badges and the Browser Matrix

There are four status badges that correspond to the three states of a finished test: Passing, Failed, Error, and Unknown.

This status is set if the build errors out due to an internal error (one or more sessions have crashed)
This status is set if one or more jobs of the latest build haven't been reported as passed or failed. This state is equivalent to Finished.

With the browser matrix, you can keep track of the test status of your project for various browser/platform/operating system combinations.

Setting Up Status Badges for Test Results

  1. Copy this markdown code into your GitHub README.

    [![Sauce Test Status](](

    Alternatively, you can use this HTML code on your project site.

    <a href="">
      <img src="" alt="Sauce Test Status"/>

    Multiple Projects, Multiple Accounts

    If you just have one project, you can use your main Sauce account name. If you have multiple projects, you will want to create a sub-account for each project. 

  2. Run your tests.

  3. Make sure to set a build number, a pass/fail status, and a public, share, or public restricted visibility for every test that runs using the Test Configuration Options.
    You'll know that these are set correctly if your tests have a status of Pass or Failed instead of Finished on your dashboard, and that a build number is also displayed.

Setting Up the Browser Matrix Widget

Copy this markdown code into your project's GitHub README.

[![Sauce Test Status](](

Alternatively, you can add this HTML to your project site.

<a href="">
  <img src="" alt="Sauce Test Status"/>

Status Images for Private Accounts

If you want to display the build status of a private Sauce account, you need to provide a Hash-based Message Authentication Code (HMAC) token generated from your username and access key.

This example shows how to generate an HMAC token using Python:

from hashlib import md5
import hmac
"?auth=" +"YOUR_SAUCE_USERNAME:YOUR_SAUCE_ACCESSKEY", None, md5).hexdigest()

Once you have the token, append it to the badge URL:


  1. Anonymous

    What is the refresh time of badges and matrixes? I've just run a build, and in the browser matrix ( only a few of the tested browsers appear; while in the badge page ( shows them all.


    Nonetheless, all items in the badgepage appear in gray, while they should be green. Note that the results in the table are marked as "Pass".

    1. Anonymous

      Same behaviour here. All tests are either passed or failed, and still both badge and browser matrix shows UNKOWN.

    2. Anonymous

      Same issue here

  2. Anonymous

    Same here ...

  3. Anonymous

    Yup same here. Cannot get it working.

  4. Anonymous

    [![Sauce Test Status](](
  5. Anonymous

    still showing unknown


  6. Hi, we've identified the bug causing this and will deploy a fix within the next two weeks. I'll reply here when it goes out. 

  7. Anonymous

    Hello, has the fix been deployed? i still see the bug

  8. Anonymous