Due to some maintenance issues, this service has been switched in read-only mode, you can find more information about the why

and how to migrate your plugin documentation in this blogpost

Skip to end of metadata
Go to start of metadata

Plugin Information

View Pipeline: Multibranch on the plugin site for more information.

Enhances Pipeline plugin to handle branches better by automatically grouping builds from different branches.

Automatically creates a new Jenkins job whenever a new branch is pushed to a source code repository.
Other plugins can define various branch types, e.g. a Git branch, a Subversion branch, a GitHub Pull Request etc.

See this blog post for more info:https://jenkins.io/blog/2015/12/03/pipeline-as-code-with-multibranch-workflows-in-jenkins/

A component of the Pipeline Plugin.


To determine the branch being built - use the environment variable BRANCH_NAME - e.g. ${env.BRANCH_NAME}


2.21 (Mar 7, 2019)

  • JENKINS-43194 - Getting issue details... STATUS  Make SCMBinder try to abort builds in which Jenkinsfile has been modified by an untrusted contributor (PR #69)
  • Migrate Chinese localization to another plugin (PR #80)
  • JENKINS-55116 - Getting issue details... STATUS  Workaround Hack patch fix to allow at least a rescan to work when it happens (PR #83)
  • JENKINS-2111 - Getting issue details... STATUS  Integration test of new workspace naming strategy (PR #82)
  • Add gitDirectory symbol to GitDirectorySCMNavigator (PR #79)

2.20 (July 9, 2018)

  • Test fixes.

2.19 (May 17, 2018)

  • Bugfix: builds failing upon running a JobPropertyStep with error "did not yet start" if previous build was hard-killed or failed before Pipeline began running (JENKINS-51290)

2.18 (Apr 20, 2018)

  • Correct small bug from the improper use of the FlowExecutionOwner.getOrNull() call for getting the previous Properties for a step (visible as a result of JENKINS-50784)

2.17 (Jan 22, 2018)

  • Provide a BranchProperty to support setting configuring durability per-branch (supports JENKINS-47300)
  • Massive updates to dependencies and tests
  • Bugfix: JENKINS-42817 readTrusted Pipeline from SCM only works in */master

2.16 (Jun 19, 2017)

  • Bugfix: Stop removing JobProperties defined outside a step (JENKINS-44848)

2.15 (Jun 01, 2017)

  • JENKINS-34561 Option to select a script name/path other than Jenkinsfile.

2.14 (Mar 10, 2017)

2.13 (Mar 03, 2017)

  • JENKINS-33273 Load Jenkinsfile (or any file requested in loadTrusted) directly from the SCM rather than doing a checkout. Requires a compatible SCM (currently Git or GitHub).
  • JENKINS-40521 Orphaned branch projects are now effectively disabled.
  • JENKINS-41146 Help text improvement.
  • API change: AbstractWorkflowMultiBranchProjectFactory implementers may now throw IOException.

One aspect of JENKINS-33273 is that you will not get an SCM changelog from a lightweight checkout of Jenkinsfile itself---only if your script actually runs checkout scm.

This behavior change can be suppressed in case of emergency using -Dorg.jenkinsci.plugins.workflow.multibranch.SCMBinder.USE_HEAVYWEIGHT_CHECKOUT=true.

2.12 (Feb 02, 2017)

2.10 (Jan 16, 2017)

  • (warning)   Please read this Blog Post before upgrading
  • JENKINS-40906 Resolve an SCM from an SCMSource and a list of candidate target branch names
  • JENKINS-39355 Use SCM API 2.0.x APIs
  • JENKINS-32179 Branch indexing always attempts to create a new project for conflicting branch names from multiple sources
  • Added subversion based integration tests
  • If SCMSource.fetch returns null abort the build.
  • JENKINS-35698 Initial run of parameterized pipeline build should return properties default value
  • JENKINS-38987 SCMHead/SCMSource/SCMNavigator need getPronoun() to assist contextual naming
  • JENKINS-38960 Deprecate TopLevelItemDescriptor.getIconFilePathPattern() and TopLevelItemDescriptor.getIconFile(String)

2.10-beta-1 (Dec 16, 2016)

  • Updated to use new multibranch-related APIs.
  • More robust handling of invalid revisions.

2.9.2 (Nov 09, 2016)

  • 2.9.1 was corrupt.

2.9.1 (Nov 09, 2016)

  • In cases where the SCM source does not recognize a branch and fails to determine its tip revision, fail with a clearer message.

Do not use. Use 2.9.2 instead.

2.9 (Sep 23, 2016)

  • JENKINS-37005 Warn about use of the properties step from a non-multibranch project.
  • JENKINS-37538 Ensuring that readTrusted output is displayed incrementally, and can be interrupted.

2.8 (Jun 15, 2016)

2.7 (Jun 09, 2016)

  • JENKINS-34246 Integration of upstream fix to orphan or modify multibranch projects inside an organization folder as project recognizers dictate.

2.6 (Jun 02, 2016)

  • JENKINS-34596 Added readTrusted step to provide greater flexibility when building untrusted pull requests.
  • Internal refactoring to expose multibranch functionality to other plugins.

2.5 (Jun 01, 2016)

  • JENKINS-32396 Pick up dependency with new feature to suppress automatic triggers of certain branch projects.
  • JENKINS-30206 Failure to update branch projects with modified configuration (only affecting newly introduced trigger suppression property).

2.4 (May 23, 2016)

  • JENKINS-31831 Make new Pipeline Syntax link appear on multibranch Pipeline projects, and organization folders configured with the Pipeline factory.

2.3 (Apr 14, 2016)

  • JENKINS-34235 Pipeline Multibranch project icon not found in the New Item page.

2.2 (Apr 14, 2016)

  • Wrong release.

2.1 (Apr 13, 2016)

2.0 (Apr 05, 2016)

  • First release under per-plugin versioning scheme. See 1.x changelog for earlier releases.


  1. Unknown User (vitaly_il)

    >To determine the branch being built - use the environment variable BRANCH_NAME - e.g. ${env.BRANCH_NAME}

    It seems be wrong - as far as I see, we're getting Git branch name into CHANGE_BRANCH, and BRANCH_NAME is always "master".

  2. Unknown User (priyatham)


    I integrated Jenkins with Github using web hooks and I created a multi-branch pipeline and I am using JenkinsFile.

    Jobs are created automatically and I am able to run the tests when a PR is created.Once the tests are passed my pipeline waits for the code review to be completed before merging.

    I would like to merge the PR when the code review is done.

    I am pushing all the Web hook events from Github to Jenkins.

    How can I resume my pipeline when a code-review event is pushed to my Jenkins.

    Please help me if anyone worked on this.