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
1.0 (archives)
Jul 18, 2011
Source Code
Issue Tracking
Pull Requests
Open Issues
Pull Requests
Bap (id: bap)
Usage Installations 2014-Oct 1140
2014-Nov 1183
2014-Dec 1184
2015-Jan 1258
2015-Feb 1280
2015-Mar 1369
2015-Apr 1422
2015-May 1509
2015-Jun 1500
2015-Jul 1589
2015-Aug 1576
2015-Sep 1621

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.