Determine tag that triggered build


I have a build that is triggered by tags matching a wildcard expression (e.g. server-*). I would like to find out the exact tag that triggered the build and use it in my build script. Does anyone know if this is possible?

I imagine I could use something like:

git tag -l --points-at HEAD

to get the tags on the current commit but there is every possibility in my situation that the same commit may end up with multiple matching tags. I have searched for predefined variables supplied by Bitbucket but cannot find anything. It would be great if it supplied variables like TRIGGER_BRANCH, TRIGGER_TAG or something that I could reference.

thanks for any advice,


1 answer

0 vote

Hi Steven,

There are default environment variables you can use, such as


See our documentation.

Suggest an answer

Log in or Join to answer
Community showcase
Piotr Plewa
Published Dec 27, 2017 in Bitbucket

Recipe: Deploying AWS Lambda functions with Bitbucket Pipelines

Bitbucket Pipelines helps me manage and automate a number of serverless deployments to AWS Lambda and this is how I do it. I'm building Node.js Lambda functions using node-lambda&nbsp...

1,305 views 1 5
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you
Atlassian Team Tour

Join us on the Team Tour

We're bringing product updates and pro tips on teamwork to ten cities around the world.

Save your spot