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 Promoted Builds (Simple) on the plugin site for more information.

Simpler version of Promoted Builds Plugin, with only manual promotion of builds.

This plugin adds a Promoted Builds section in the main Jenkins configuration page. Here you can configure the names of your promotion levels and the icons to use in the Build History. All builds run after the plugin is installed will show the promotion level on the build status page, and users with "Update Run" permission will be able to promote the build.

Unlike the Promoted Builds Plugin, this plugin defines metadata only; there is no action associated with the promotion. It just shows the promotion level on the build page and a badge icon in the Build History on the project page. You may use this metadata however you like, such as using the Remote API to find artifacts of a particular promotion level. The Copy Artifact Plugin can also copy artifacts of a selected promotion level from other jobs.

Click the help icon for Promoted Builds in the main configuration page for information on how to use the Remote API to query for promoted builds, or how to promote builds that were run before installing the plugin.

Change Log

Version 1.9 (Mar 29, 2011)
  • Japanese translation updates.
Version 1.8 (Feb 25, 2011)
  • Rerelease 1.7 to properly set required Jenkins version.
Version 1.7 (Feb 13, 2011)
  • Add configuration option for whether promotion to each level automatically marks the build as "keep forever". (JENKINS-7284)
  • When using Copy Artifact Plugin, check promotion level of parent build for maven or matrix project when copying artifacts from a particular maven module or matrix configuration. (JENKINS-7900)
  • Add ability to upload image files into JENKINS_HOME/userContent directory from global config page.
Version 1.6 (May 12, 2010)
  • Avoid many exceptions in log when Copy Artifact plugin is not also installed.
Version 1.5 (May 8, 2010)
  • Fix setting in Copy Artifact build step so it shows the saved value for promotion level when returning to job config page.
  • Add support in Copy Artifact build step to get the promotion level from a build parameter or environment variable.
Version 1.4 (Apr 17, 2010)
Version 1.3 (Apr 13, 2010)
Version 1.2 (Feb 10, 2010)
  • Update code for more recent Hudson.
Version 1.1 (Jul 14, 2009)
  • Set visibility of exported data to enable xpath query with depth=1 instead of depth=2 (which exposes more data and slows down the query).
Version 1.0 (Jun 23, 2009)
  • Initial release.


  1. Unknown User (mookie)

    Many thanks, this plugin is excellent. I'm using it in our company and we're really happy, as many promotion statuses makes hudson more collaborative among quality and development members. It could be nice to have in a future an ability to trigger an action when promotion status is changed eg. e-mail notification etc.


  2. Unknown User (josesa)

    Are there permalinks to each "last" Promotion level as there is for lastStableBuild or lastSuccessfulBuild ?

    1. Unknown User (mindless)

      No, promotion is only available via remote API and with copy artifacts plugin.
      Feel free to file a feature request at issues.jenkins-ci.org for permalinks.

      1. Unknown User (josesa)

        Added feature request in JIRA - JENKINS-11440 as indicated.

  3. Unknown User (mfharis)

    The plugin is excellent but I can't find a way to execute my Ruby script under 'Actions' section of Promote Process. I can see 'Execute Windows Shell' or 'Execute Shell script' but not 'Execute Ruby script' as does I can see in Post-Build Action of my build.

    Could anyone help me in this regard?

  4. Unknown User (jameshowe)

    This doesn't appear to work any more (Jenkins 2.121.3). The UI to promote a build does not appear.