Conditional BuildStep Plugin

Skip to end of metadata
Go to start of metadata

Plugin Information

Plugin ID conditional-buildstep Changes In Latest Release
Since Latest Release
Latest Release
Latest Release Date
Required Core
1.3.3 (archives)
Nov 13, 2013
maven-plugin (version:1.480.3)
run-condition (version:1.0)
token-macro (version:1.5.1)
Source Code
Issue Tracking
Pull Requests
Open Issues
Pull Requests
Dominik Bartholdi (id: imod)
Bap (id: bap)
Usage Installations 2014-Oct 12637
2014-Nov 13066
2014-Dec 13380
2015-Jan 14222
2015-Feb 14879
2015-Mar 16087
2015-Apr 16554
2015-May 17057
2015-Jun 18024
2015-Jul 18888
2015-Aug 19211
2015-Sep 19956

A buildstep wrapping any number of other buildsteps, controlling their execution based on a defined condition.


This plugin requires the TokenMacro Plugin and the Run Condition Plugin to be installed!

  • Ever wanted to have more control whether a step should be executed or not?
  • Want to reduce the number of jobs doing nearly the same thing?

Add a conditional buildstep which acts as a container. It will allow you to define a condition controling the execution of the step(s).


There are multiple conditions one can choose of, these are all defined by the Run Condition Plugin

Missing builder
If you're not able to add the builder of your choice within a conditional build step (because it's not available within the dropdown), then this is likely because the builder does not provide a @DataBoundConstructor constructor and/or the Descriptor does not extend hudson.tasks.BuildStepDescriptor. For non programmers: the plugin you would like to use does not yet follow the newest Jenkins coding guidelines. Without this, the conditional buildstep plugin is not able to work with it.

Conditional step (single)

This build step allows you to select any build step and define a condition to control whether the step should be executed.
For reasons why you might want to use this step, see Why use Conditional step (single)?

Conditional steps (multiple)

A 'Conditional steps (multiple)' container is able to contain any number of any other buildsteps (e.g. Shell, Ant, Maven,...) and you can have any number of 'Conditional Steps' containers, each configured with a different condition.


please check out the examples at the Run Condition Plugin

Known issues

Version History

1.3.3 (13. Nov. 2013)

  • fix JENKINS-20543 fix "NoSuchMethodError: org.jenkinsci.plugins.conditionalbuildstep.ConditionalBuildStepHelper.getContainedBuilders()"

1.3.2 (10. Nov.2013)

  • add helper (ConditionalBuildStepHelper) to support working with wrapped build steps to support JENKINS-18967
  • enhance ConditionalBuildStepHelper to also return pre- and post builders from a maven project

1.3 (16. July 2013)

1.2.2 (2. June 2013)

  • fix JENKINS-17836 exception if there is no builder defined within the conditional build step

1.2.1 (1. Nov 2012)

  • Fix JENKINS-13871 Using "Conditional build step" and "Parameterized build step" in same step is preventing parallel executions of same job

1.2 (11. Okt 2012)

  • Fix JENKINS-14118 show builds triggered through "Conditional buildstep" plugin reported as downstream builds for the current build.

1.1 (6. May 2012)

  • Fix JENKINS-13618 Unable to use multiple Conditional Steps in the Prebuild section of Multi configuration job

1.0 (31. March 2012)

0.0.3 (31. Dec. 2011)

  • Fix JENKINS-12036 - conditional buildsteps does not support matrix build

0.0.2 (14. Nov. 2011)


  • initial

Help and Support

For Help and support please use the Jenkins Users mailing list or the Issue tracker (JIRA).


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

Add Comment