Guide › Jobs and connections
Store a key or password your app needs
Where: Overview > Jobs and connections > Secrets
Secrets hold private values your app uses, such as a key for a payment service. They are kept beside your data, never in the app's code or in a download, and never shown again once saved.
Set it up
- Build the app. The card appears after that, and lists anything the app still needs.
- Press a listed name to fill it in, or type your own in capitals, such as STRIPE_KEY.
- Paste the value.
- Choose where it applies: Preview and live, Preview only (a test key) or Live site only (a live key). The last appears once the site is published.
- Press Save.
To change a value, type the same name and press Replace. Remove deletes it, and anything using it stops getting a value.
If something goes wrong
- That is not a Stripe secret key: copy the secret key, which starts with sk_test_ or sk_live_, from Developers, API keys in Stripe. Start with the test key, which takes no real money.
- A value is one line: paste it again without line breaks.
- A project keeps at most 40 secrets. Remove one you no longer use.