---
updatedAt: 2026-11-05T17:58:07.000Z
agentTools:
  projectIndex: https://docs.atono.io/llms.txt
---

# Environments

Define environments like `dev`, `test`, `stage`, and `prod` to manage feature flags and track bugs at every stage of your development process.

The Environments page allows you to define and manage the different stages your team uses throughout the software development life cycle.

By setting up environments for stages like development, testing, staging, and production, you can tailor feature flag configurations and bug tracking to the specific needs of each phase.

<Image align="center" border={false} width="750px" src="https://files.readme.io/bdfaedbc9abe23a5d96b7f52c4bd998624d021bc942e1bd59b864a865a1e8987-environments.png" />

<br />

***

# Default environments

An Atono workspace includes four default environments: `dev`, `test`, `stage`, and `prod`.

* **Development (**`dev`**)**: Active code development and initial testing by developers, supporting rapid iteration and debugging.
* **Testing (**`test`**)**: Executes automated and manual tests to validate software functionality and catch bugs before staging.
* **Staging (**`stage`**)**: Pre-production environment mirroring production for final validation and user acceptance testing.
* **Production (**`prod`**)**: Live environment where the software is deployed for end users, ensuring high stability and performance.

These default environments cover common needs, but Workspace Owners and Administrators can rename them or create additional environments to match your teams' specific workflows or requirements.

<br />

***

# Access the Environments page

The Environments page displays all the environments in your Atono workspace in a table, including each environment's name and key. Anyone can access the Environments page and copy an environment key.

1. In the Atono workspace header, click the name of your workspace.
2. From the menu, select **Environments**.

<br />

## Copy an environment key

To configure a feature flag, you’ll need to provide an environment key in your code to identify which Atono environment and workspace it applies to.

Click the **copy** icon next to the environment key to copy it to your clipboard.

<br />

***

# Manage environments

> Only Workspace Owners and Administrators can create, rename, reorder, or delete environments.

<br />

## Create an environment

1. On the Environments page, click **Create environment**.
2. In the 'Create environment' dialog, enter a unique name for your environment.
   * Environment names can include lowercase letters, numbers, dashes, and underscores.
3. Click **Create environment**, or click **X** to cancel.

<br />

## Rename an environment

Rename an environment to better match its role in your development lifecycle.

1. On the Environments page, hover over the environment you want to rename.
2. Click the **ellipsis** (...) icon that appears at the far right of the table row.
3. From the menu, select **Rename**.
4. In the 'Rename environment' dialog, enter your environment's current name as a safety measure, and then click **Continue**.
5. Enter the new name and click **Rename environment**, or click **X** to cancel.

> ⚠️ Be careful renaming an environment
>
> Renaming an environment may break feature flag functionality configured for it, for example, if your code or tools refer to the environment by its name. The environment key stays the same.

<br />

## Reorder environments

Reorder environments to match your workflow and prioritize frequently used environments when managing feature flags.

1. On the Environments page, hover over the environment you want to move.
2. When the drag handle appears, click and drag the environment to a new position in the list.

<br />

## Delete an environment

Delete unused environments to reduce clutter and keep your list of active environments organized.

1. On the Environments page, hover over the environment you want to delete.
2. Click the **ellipsis** (...) icon at the far right of the table row.
3. From the menu, select **Delete**.
4. In the 'Delete environment' dialog, enter the environment's current name, and then click **Delete environment**, or click **X** to cancel.