Jenkins : Fail The Build Plugin

Plugin Information

View Fail The Build on the plugin site for more information.

Change log


  • Set or change the status of a build
    This plugin is provided to help test the behaviour of your Jenkins configuration.
    Use this plugin to test notifiers, publishers, promotions, build pipelines ...

You can only make the build result worse than it is at the point the build step runs!


This plugin is compatible with any version of Jenkins (1.396+)


Install from the Plugin Manager (Manage Jenkins > Manage Plugins) under "Build Tools".

To install manually, download the latest plugin from and use the Upload Plugin option in the Advanced tab of the Plugin Manager.


Add the build step, by clicking "Add build step" and selecting "Set the build result"


Select the status that you want. Options are Success, Unstable, Failed, Aborted, and Cycle.

Selecting Cycle will cause the result to cycle based on the build number. Image of Build history with Cycle selected below.

Advanced options

Click the Advanced button to enable the results to be set for specific build numbers.

Success, Unstable, Failed, Aborted

For each result, a list of build numbers for which it should be set instead of the value in the Result drop down.

Change log

1.0 (18/07/2011)

  • Initial release

Questions, Comments, Bugs and Feature Requests

Please post questions or comments about this plugin to the Jenkins User mailing list.
To report a bug or request an enhancement to this plugin please create a ticket in JIRA.