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.Related
Environment variables
Setting per-environment env vars.
Secrets
Secret-store mechanics.
Staging vs production
Promotion patterns.
