Docs
Reference

Bitrise secrets

Secrets a Bitrise workflow reads at build time.

Secrets a Bitrise workflow reads at build time.

The connection

WhatThis provider
VendorBitrise
Keybitrise-secrets
Availabilityavailable. You can connect it today.
Credential penv holdsbitrise-token
Values read backyes
Activationon-next-deploy

What it moves

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

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
importskip_existing, new_version, fail
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 sealedyesBitrise sends this raw, with no Bearer prefix.

What a mapping asks for

Answered once per environment you map.

FieldLabelKindRequiredAdvancedWhat it is
appSlugApptextyesnoThe slug in your Bitrise app URL.
isProtectedHide values from the APIyes or nonoyesOne way: once hidden, a value cannot be read back or changed, only deleted and remade. Starts at false.
isExposedForPullRequestsExpose to pull requestsyes or nonoyesBuilds from forks would read it. Starts at false.
expandInStepInputsExpand in step inputsyes or nonoyesStarts at false.

Permissions it needs

penv probes for these when it verifies the connection.

PermissionDirectionsBlockingWithout it
apps:readevery directionyesPreview cannot list the app's secrets.
apps:writeexportyesExport cannot write anything.