Fail The Build Plugin

Skip to end of metadata
Go to start of metadata

Plugin Information

Plugin ID fail-the-build-plugin Changes In Latest Release
Since Latest Release
Latest Release
Latest Release Date
Required Core
Jul 18, 2011
Source Code
Issue Tracking
Open Issues
Bap (id: bap)
Usage Installations 2013-Apr 634
2013-May 668
2013-Jun 680
2013-Jul 738
2013-Aug 729
2013-Sep 734
2013-Oct 791
2013-Nov 806
2013-Dec 798
2014-Jan 858
2014-Feb 891
2014-Mar 927

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.


plugin-builder plugin-builder Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.