Skip to content

Commit 11f5307

Browse files
anagstefmanovotny
andauthored
Update staging environment setup instructions (#3056)
Co-authored-by: Michael Novotny <[email protected]>
1 parent 49fec46 commit 11f5307

File tree

1 file changed

+3
-3
lines changed

1 file changed

+3
-3
lines changed

docs/guides/development/managing-environments.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -38,9 +38,10 @@ When deploying to production, you must first activate your `Production` environm
3838

3939
Staging environments enable you to internally test and demo changes to your application or website before deploying them to production. Currently, Clerk only offers **Development** and **Production** instances. Official support for **Staging** instances is still on the [roadmap](https://feedback.clerk.com/roadmap/de417dd1-fa2e-4997-868f-4c9248027e7d). However, you can set up a "staging environment" by creating a separate Clerk application with a separate domain.
4040

41-
Creating a separate Clerk application will prevent you from using live production environment data in your staging environment. If you are on a Pro, Enterprise, or Startup plan, **Clerk will fully upgrade your staging application for free.**
41+
Creating a separate Clerk application will prevent you from using live production environment data in your staging environment.
4242

43-
It is important to note that when you use a separate Clerk application for your staging environment, changes to this application will not be automatically mirrored in your main application for your production environment. You must manually make these changes yourself if you want them to be reflected in both applications.
43+
> [!IMPORTANT]
44+
> When you use a separate Clerk application for your staging environment, changes to this application **will not be automatically mirrored** in your main application for your production environment. You must manually make these changes yourself if you want them to be reflected in both applications.
4445
4546
### Set up a staging Clerk application
4647

@@ -49,7 +50,6 @@ The following steps will help you set up a new Clerk application with a staging-
4950
1. **Set up a subdomain** - This will be your staging domain. For example, if your domain is `my-site.com`, you could use `staging.my-site.com`.
5051
1. **Create a new Clerk app** - Your staging environment will connect to this app instead of your main one. See [the Clerk quickstart guide](/docs/getting-started/quickstart/setup-clerk) to learn how to create a Clerk app.
5152
1. **Deploy and configure your staging app's production instance** - Using production API keys will make your staging app more secure. Follow the [Deploy to production](/docs/guides/development/deployment/production) guide to do so.
52-
1. **Contact Clerk support to upgrade your staging app for free** - If you are on a Pro, Enterprise, or Startup plan, Clerk will fully upgrade your staging app for free.
5353

5454
### Alternatives
5555

0 commit comments

Comments
 (0)