Skip to main content
Every project starts with two environments: Preview (auto-deploys every change) and Production (manually promoted). You can add more — staging, QA, per-team — as needed.

Default environments

Adding a custom environment

1

Settings → Environments → Add environment

Pick a name (staging, qa, demo-acme).
2

Configure secrets per environment

Each environment has its own secrets store. Stripe test keys in staging; live in production.
3

Promote into the environment

From any preview, click “Promote to [env name]”.
4

(Optional) Add a domain

staging.yourapp.com → CNAME to the staging environment.

Per-environment differences

What can vary between environments: What can’t: For schema differences across environments, use branching instead of environments.

Deleting an environment

Settings → Environments → [env] → Delete. Removes the environment, its secrets, and (if attached) the custom domain. Other environments are unaffected.

Environment variables

Setting per-environment env vars.

Secrets

Secret-store mechanics.

Staging vs production

Promotion patterns.
Last modified on April 18, 2026