Skip to content

fix: update the Kinde environments page #739

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
tamalchowdhury wants to merge 6 commits into
base: main
Choose a base branch
from
Open

fix: update the Kinde environments page #739

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
6073d77
update the kinde environments page
tamalchowdhury May 24, 2026
62e58ff
update the environment page
tamalchowdhury May 26, 2026
a00bcde
initial update the go-live checklist page
tamalchowdhury May 27, 2026
66d97a2
update the go-live checklist
tamalchowdhury May 27, 2026
b7e91d5
coderabbit fix done
tamalchowdhury May 28, 2026
5088b8f
fix the required changes, add screenshot, and sibling doc refs
tamalchowdhury Jun 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
127 changes: 85 additions & 42 deletions src/content/docs/build/environments/environments.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,9 +1,15 @@
---
page_id: d95a8edd-f61a-4095-a80e-ffd67f90a438
title: About environments
title: Manage Kinde environments
description: Overview of Kinde environments including production and non-production environments, environment management, rate limiting considerations, and development workflow best practices.
sidebar:
order: 1
label: Manage environments
relatedArticles:
- 6018b610-bb9d-48b4-a226-f88f7fc68296
- 37e847e2-b6c7-4cf1-86d3-7c607b2bffbd
tableOfContents:
maxHeadingLevel: 3
app_context:
- m: settings
s: environment_details
Expand All @@ -12,81 +18,118 @@ topics:
- environments
- development
- production
- staging
- testing
- environment management
- environment switching
- environment settings
sdk: []
languages: []
audience: developers
complexity: beginner
keywords:
- environments
- production environment
- non-production
- staging
- testing
- non-production environment
- staging environment
- testing environment
- environment management
- rate limiting
updated: 2024-01-15
- create environment
- delete environment
- rename environment
- environment settings
- environment switcher
- switch environment
- dev environment
updated: 2026-05-27
featured: false
deprecated: false
ai_summary: Overview of Kinde environments including production and non-production environments, environment management, rate limiting considerations, and development workflow best practices.
ai_summary: "Kinde supports multiple environments to match your software development workflow. Every Kinde business includes one production environment by default. Free plans are limited to one extra non-production environment. You will need a paid plan to create more than one non-production environment — such as dev, test, or staging. Use the environment switcher in the top-left of the dashboard to switch between environments or access environment settings. You can create, rename, delete (non-production only), and configure environment settings including analytics integrations. The production environment cannot be deleted and must go through the go-live checklist to be set to live. Currently, there is no built-in way to copy configuration between environments, but a separate guide covers how to manage this."
---

Kinde allows you to run multiple environments to support your software development cycle. All plans come with one production environment and one non-production environment. Higher plans come with additional non-production environments, so you can add staging, testing, beta, etc. to meet your team’s needs.
Kinde allows you to run multiple environments to support your software development cycle.

<Aside>
Kinde environments at a glance:

You must use the default production environment (the one you got when you first signed up to Kinde) as your production environment. This is important for when you are [ready to go live](/build/environments/production-to-live/). You cannot delete the production environment or add additional production environments.
- All Kinde businesses come with one production environment.
- You can create additional non-production environments (e.g., dev, test, staging, etc.)
- Free plans are limited to one extra non-production environment.
- You will need a paid plan to create multiple non-production environments.
- You cannot delete the production environment.

</Aside>
You can see the environment you are working in at the top left of the home page when signed in. To make the production environment live, [follow the go-live checklist](/build/environments/production-to-live/).

You can see the environment you are working in at the top left of the home page when signed in.
## Manage environments

## Take care using multiple environments
### Environment switcher

Unless you are a developer, we recommend you stay in the production environment for viewing and working with your Kinde account.
![kinde environment switcher](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/2f35b1fe-faa5-4d54-7abb-1330aba28700/socialsharingimage)

1. Sign in to your Kinde dashboard.
2. On the top left of the screen, you will see the environment you are currently in.
3. Select the environment drop-down to:
- Switch to another environment
- View all your environments (and create additional ones)
- View and edit the current environment settings

### Create a new environment

For developers who want to test new user configurations or make other changes, do this in a non-production (testing or staging) environment first, before replicating in the production environment.
<Aside type="upgrade">
Free plans are limited to one extra non-production environment. You will need a [paid plan](https://kinde.com/pricing/) to create multiple non-production environments.
</Aside>

1. From the environment drop-down, select **All environments**.
2. In the **Environments** page, select **Add environment**.
3. Enter a name for the environment (e.g., Development).
4. Enter a dev-friendly code for the environment (e.g., `dev`).
5. Select **Save**.

## Rate limiting for live production environments
You will see the new environment in the list.

Before you make your production environment live, [follow ](/build/environments/production-to-live/)[this checklist](/build/environments/production-to-live/).
<Aside type="warning">
You can only add non-production environments to Kinde.
</Aside>

It is critical that all [third-party authentication](/authenticate/authentication-methods/set-up-user-authentication/) connections (such as social connections or enterprise connections) are set up with the third-party’s Client ID and Client secret. If you leave these fields blank during setup, Kinde’s credentials will be used as a proxy, and rate limits will apply.
6. Select **Switch to this environment** on the environment card to start working in the new environment.

Note that you can leave these fields blank in your non-production environments. Non-production environments cannot be made live.
### Rename an environment

## View and manage environments
1. From the environment drop-down, select **All environments**.
2. On the environment you want to rename, select the **three dots menu** (...).
3. Select **Edit environment**.
4. Update the environment name and select **Save**.

Select the environment drop-down in the top left of the home screen. From here you can:
- Switch to another environment
- View all your environments (and create additional ones)
- View environment settings
### Delete a non-production environment

## Add an environment
1. From the environment drop-down, select **All environments**.
2. On the environment you want to delete, select the **three dots menu** (...).
3. Select **Delete environment**.
4. Confirm you want to delete the environment. This action is irreversible.

You can only add non-production environments.
<Aside>
You cannot delete the production environment.
</Aside>

1. Select the environment drop-down in the top left of the home screen, and select **All environments**.
2. On the **Environments** page, select **Add environment**.
3. Enter a name and code for the environment, then select **Save**.
### Update environment settings

## Switch between environments
1. From the environment drop-down, select **Environment settings**.
2. Update the environment name as needed.
3. Optionally, add third-party analytics tracking codes such as Google Analytics, Hotjar, and Contentsquare.

Select the environment drop-down in the top left of the home screen, and select the environment you want to switch to.
<Aside type="upgrade">
You will need a paid plan to add third-party analytics tracking codes. See Kinde [pricing](https://kinde.com/pricing/) for more details.
</Aside>

## Change the name of an environment
If you are editing the production environment, you can also update the environment status to **Live**. See the [go live checklist](/build/environments/production-to-live/) for more details.

1. Switch to the environment you want.
2. Select the environment drop-down in the top left of the home screen and choose **Environment settings**.
3. Change the environment name and select **Save**.
## Kinde environment FAQs

## Delete a non-production environment
### Who should use multiple environments?

You cannot delete the production environment.
If you want to test new user configurations or make other changes, do so in a non-production environment (e.g., testing or staging) first, then replicate the changes in production.

1. Select the environment drop-down in the top left of the home screen, and select **All environments**.
2. On the environment you want to delete select the three dots, then select **Delete environment**.
3. Confirm you want to delete the environment. This action is irreversible.
Unless you are a developer, we recommend you stay in the production environment for viewing and working with your Kinde account.

## Move data between environments
### Can I copy configuration between environments?

There is currently no way to shift data or configuration settings between environments. For now, you need to replicate settings manually, and export/import data or use the [Kinde Management API](https://docs.kinde.com/kinde-apis/management/). It's on our roadmap to make this easier someday.
No. You cannot copy configuration settings between environments using the Kinde dashboard. However, you can use the Kinde Management API to achieve this — [follow this guide](/developer-tools/guides/manage-kinde-configuration/).
Loading
Loading