Find plugins

Bitbucket1.1.6Minimum Jenkins requirement: 1.642.3ID: bitbucket

Plugin Information

Plugin ID



In Latest Release
Since Latest Release

Latest Release
Latest Release Date
Required Core

1.1.6 (archives)
Nov 02, 2017
job-dsl (version:1.40, optional)
mercurial (version:1.54)
scm-api (version:1.3)
git (version:2.3.5)
branch-api (version:1.11)
structs (version:1.5)

Source Code
Issue Tracking
Pull Requests

Open Issues
Pull Requests
n/a (id: fbelzunc)



2016-Oct 7420
2016-Nov 7923
2016-Dec 7931
2017-Jan 9086
2017-Feb 9132
2017-Mar 10086
2017-Apr 9953
2017-May 10382
2017-Jun 10540
2017-Jul 10776
2017-Aug 11393
2017-Sep 11496

This plugin is currently looking for a maintainer.


Bitbucket plugin is designed to offer integration between Bitbucket and Jenkins.

It exposes a single URI endpoint that you can add as a WebHook within each Bitbucket project you wish to integrate with. This single endpoint receives a full data payload from Bitbucket upon push (see their documentation), triggering compatible jobs to build based on changed repository/branch.

Since 1.1.5 Bitbucket automatically injects the payload received by Bitbucket into the build. You can catch the payload to process it accordingly through the environmental variable $BITBUCKET_PAYLOAD.


Configure your Bitbucket repository with a Webhook, using URL JENKINS_URL/bitbucket-hook/ (no need for credentials but do remember the trailing slash). The older-style HTTP POSTs from Bitbucket are also supported but deprecated.

On each push, the plugin:

  1. Scans Jenkins for all jobs with "Build when a change is pushed to Bitbucket" option enabled
  2. Each each job matched:
    1. If the job's SCM (git) URL "loosely matches" that of the git repository listed inside the Bitbucket-provided payload, AND
    2. If the job's SCM (git) detects that the remote repository has changes, THEN
    3. A full build of the job will be queued

The "loose matching" is based on the host name and paths of the projects matching.


The current supported dsl is as follows:

freeStyleJob('test-job') {



1.1.6 (2. Nov 2017)


1.1.5 (26. Jan 2016)

  • fix JENKINS-32372 Inject the Payload into the build through $BITBUCKET_PAYLOAD

1.1.4 (28. Dec 2015)

1.1.3 (16. Oct 2015)

  • fix JENKINS-29096 Advice users when they don't use the right hook url - last `/`
  • fix JENKINS-30985 Jobs with the same git repository defined several times in the scm should be triggered only once

1.1.2 (4. August 2015)

1.1.1 (9. July 2015)

  • Allow Webhooks 2.0

1.1.0 (10. March 2015)

  • fix JENKINS-24999 Build triggered by SCM change without activating trigger in the job configuration
  • fix JENKINS-26413 BitBucket trigger doesn't need to InitializeLogFile
  • fix JENKINS-26489 Action report for the bitbucket polling log on web UI
  • fix JENKINS-26805 Job is not triggered after merging a branch


  • initial implementation
ArchivesGet past versions
This plugin has no labels