Conditional BuildStep

This plugin is up for adoption! We are looking for new maintainers. Visit our Adopt a Plugin initiative for more information.

conditional buildstep conditional buildstep plugin conditional buildstep

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


Getting Help

For Help please use the Jenkins Users mailing list or the Issue tracker (Jira).


Licensed under the MIT Licence.