Docs
Reference

Bitbucket workspace variables

Pipeline variables shared by every repository in a Bitbucket workspace.

Pipeline variables shared by every repository in a Bitbucket workspace.

The connection

WhatThis provider
VendorBitbucket
Keybitbucket-workspace-variables
Availabilityavailable. You can connect it today.
Credential penv holdsbitbucket-token
Values read backno
Activationon-next-deploy

What it moves

DirectionWhat it does
exportWrites names and values from penv into the store.

Bitbucket returns no value once it holds one, so penv can write here and cannot read back.

When a written value goes live

on-next-deploy. A new value waits there and arrives with your next deploy.

What happens to a name that exists

DirectionPolicies you can pick
exportcreate_only, overwrite, overwrite_and_prune

How syncs work says what each one does.

How you connect

You paste a credential you already hold. penv seals it and never shows it again.

FieldLabelKindRequiredWhat it is
tokenAccess tokensecret, masked here and sealedyesA Repository or Workspace Access Token carrying pipeline:variable. The similar-looking pipeline:write does not grant variable writes.

What the connection asks for

Fixed when you connect, and shared by every mapping on it.

FieldLabelKindRequiredAdvancedWhat it is
workspaceWorkspacetextyesnoThe first path segment of your repository's URL. One connection covers one workspace.

Permissions it needs

penv probes for these when it verifies the connection.

PermissionDirectionsBlockingWithout it
pipelineevery directionyesPreview cannot list what is already there, so a prune cannot be planned.
pipeline:variableexportyesExport cannot write anything.