From 16674584b67a81651bee2032a41e014df2ca280f Mon Sep 17 00:00:00 2001 From: Stefanos Anagnostou Date: Mon, 9 Feb 2026 12:44:30 +0200 Subject: [PATCH 1/2] Update staging environment setup instructions --- docs/guides/development/managing-environments.mdx | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/guides/development/managing-environments.mdx b/docs/guides/development/managing-environments.mdx index 0e07163f7b..eaa5473aa8 100644 --- a/docs/guides/development/managing-environments.mdx +++ b/docs/guides/development/managing-environments.mdx @@ -38,7 +38,7 @@ When deploying to production, you must first activate your `Production` environm 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. -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.** +Creating a separate Clerk application will prevent you from using live production environment data in your staging environment. 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. @@ -49,7 +49,6 @@ The following steps will help you set up a new Clerk application with a staging- 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`. 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. 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. -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. ### Alternatives From 85ea601f16780d7c7420dc5679d75814b7c0772d Mon Sep 17 00:00:00 2001 From: Michael Novotny Date: Tue, 10 Feb 2026 09:34:59 -0600 Subject: [PATCH 2/2] Apply suggestion from @manovotny --- docs/guides/development/managing-environments.mdx | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/guides/development/managing-environments.mdx b/docs/guides/development/managing-environments.mdx index eaa5473aa8..d643b98f5a 100644 --- a/docs/guides/development/managing-environments.mdx +++ b/docs/guides/development/managing-environments.mdx @@ -40,7 +40,8 @@ Staging environments enable you to internally test and demo changes to your appl Creating a separate Clerk application will prevent you from using live production environment data in your staging environment. -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. +> [!IMPORTANT] +> 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. ### Set up a staging Clerk application