Due to some maintenance issues, this service has been switched in read-only mode, you can find more information about the why

and how to migrate your plugin documentation in this blogpost

Skip to end of metadata
Go to start of metadata

Plugin Information

View Embeddable Build Status on the plugin site for more information.

Older versions of this plugin may not be safe to use. Please review the following warnings before using an older version:

This plugin allows Jenkins to expose the current status of your build as an image icon badge via a fixed URL. You can put this URL into other sites (such as GitHub README) so that people can see the current state of the job (last build) or for a specific build.

Basic Usage

Once this plugin is installed, you'll see Embeddable Build Status Icon as one of items in the left menu navigation for a job or build of a job respectively.

When you click this icon, you get several links to an icon that shows the current Build Status for your job or the status of a specific build respectively. 
You can paste any of these URLs in other sites so people can see the current state of your build.

Open Issues

Key Summary T Created Updated Due Assignee Reporter P Status Resolution

Scheduled for next release

Key Summary T Created Updated Due Assignee Reporter P Status Resolution


2.0.1 (Apr 09, 2019)

JENKINS-56625 - Getting issue details... STATUS

2.0 (Mar 04, 2019)

Final release (not further changes)

2.0-beta2 (Feb 07, 2019)

NOTE: The final v2.0 release is scheduled for Feb 14. If you have any issues with this beta please got to GitHub and report them.

  • Added license (MIT)
  • Variable renaming (see #37)
  • JENKINS-18408 - Getting issue details... STATUS
2.0-beta1 (Jan 03, 2019)
  • Fixed link encoding
  • Fixed handling for unprovided job argument for unprotected URL

  • Fixed animation state for running builds
  • Allow to select builds via Selectors (see README)
  • Allow usage of customizable unprotected URL without job or build reference
  • Allow to configure badges via pipeline scripts (see README)
  • Allow to customize label (subject), status and color
1.9 (Feb 06, 2016)
1.8 (Aug 31, 2015)
  • Badges for aborted builds (JENKINS-19319)
  • Fix ETag header quoting to respect RFC 7232
  • Some minor "plastic" style image fixes
1.7 (Mar 24, 2015)
  • New badge style: flat, with option to choose the old ("plastic") style (JENKINS-26705)
  • Option to omit view name from the URL (JENKINS-26585)
1.6 (Nov 29, 2014)
  • Support for build status badge for a specific build of a job (JENKINS-25306)
1.5 (Aug 25, 2014)
1.4 (May 31, 2013)
  • ability to expose badges even when Jenkins has no anonymous read access (JENKINS-17798)
1.3 (Mar 05, 2013)
  • missing icon
1.2 (Mar 1st, 2013)
  • Added "unknown" image and use it for disabled and unbuilt jobs (JENKINS-15510)
  • Avoid using 302 redirects given that some browsers cache them (JENKINS-17028)
1.0 (2012/05/09)
  • Initial version


  1. Unknown User (peter_budo)

    Provided links are not usable with github as they get broken image sign, guess it is down to the redirect

  2. Unknown User (johntdyer)

    Anyway to do this with private jobs on Jenkins?  

    1. Unknown User (jverdeyen)

      I would like to know this one also, how can I make this accessible for anonymous users?

  3. Unknown User (fmartingr)

    Is there any way to make the images public in a private jenkins?

  4. Unknown User (5c077yp)


    for me this plugin is not working with github. I think github needs an image ending with .icon or kind of that. The given urls all don't have an ending. I am i doing sth wrong maybe ?

    1. Unknown User (nairdo)

      To get it working in Github (as of April 2014) add a &.png to the end like this:


  5. Unknown User (henriquer)

    Could we get a new version released, please? The latest one is more than a year old and there are some nice fixes merged recently.

  6. Unknown User (rrialq)

    Is possible to get the buid status of a recent build by relative position?

    For example, the build number 358 is the last build, so instead of:


    The following is possible?



    • build=0 and build=last should be equivalents in this context.
    • build=0 means the last build.
    • build=-1 means the (last - 1) build (and so on).

    Why this?

    Because it should be interesting in some cases to show not only the last build status, so the previous build statuses.

    1. Unknown User (macetw)

      This sounds like a great suggestion, where build<=0

  7. Unknown User (dickschoeller)

    It seems like GitHub is not displaying the icons in the README.md. This was mentioned earlier with a workaround, but that isn't working. It looks like they are preventing SVG format images from being included there. Any suggestions? If GitHub is going to persist in preventing SVG images, perhaps PNG could be made an option in the plugin.

    1. Unknown User (dickschoeller)

      Never mind. It was an interaction with caching and the fact the Comcast renumbered me, so my DNS was out of date.

  8. Unknown User (chensq_2016)

    Why can I see jenkins user information in the github build state link?