> ## Documentation Index
> Fetch the complete documentation index at: https://archie.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Environment colors

> Give each backend environment a color so you can tell master, staging, and feature environments apart at a glance. Choose a color when you create an environment, and change it later.

Every backend environment can have a color. The color tints the environment's branch icon and the environment selector, so you can see which environment you're working in without reading the name.

## Available colors

Pick one of ten colors: **Red**, **Orange**, **Amber**, **Lime**, **Green**, **Teal**, **Cyan**, **Blue**, **Violet**, or **Pink**.

The first swatch in the picker is special:

* **Default** appears when the environment name has a default color. The swatch is filled with that color and has a dashed outline.
* **No color** appears for every other name. The swatch is empty with a diagonal slash.

Default colors apply to these names, regardless of capitalization:

| Environment name | Default color |
| - | - |
| `master` | Green |
| `test`, `testing`, `qa`, `uat`, `staging` | Blue |

An environment with any other name has no color until you pick one. Choosing **Default** or **No color** removes the color you set and returns the environment to its default.

## Where colors show up

* **Environment selector** — the button at the top of the Backend Console takes on the active environment's color. Each row in the list shows its own color on the branch icon.
* **Environments page** — each row's branch icon uses the environment's color.
* **Frontend page** — the backend environment control in the Frontend header uses the color of the environment your frontend connects to. See [Choose the backend environment](https://archie.com/docs/frontend/connecting-to-the-backend.md#choose-the-backend-environment).

![The Environments page with the master environment's branch icon shown in green](https://mintcdn.com/archie-e998dbf6/_-PSWtH_k72JcKHJ/images/48-env-list-colors.png?fit=max\&auto=format\&n=_-PSWtH_k72JcKHJ\&q=85\&s=9f98ad8b49b868261c6b4b57cbe1a93d)

![The environment selector open, with the active environment highlighted in its color](https://mintcdn.com/archie-e998dbf6/_-PSWtH_k72JcKHJ/images/49-env-selector-colors.png?fit=max\&auto=format\&n=_-PSWtH_k72JcKHJ\&q=85\&s=88835c75bfff3bc8a8a40d819bda4e6d)

## Choose a color when you create an environment

The create-environment modal has a **Color** field between the name and the branch mode. Select a swatch to set the color. Leave **Default** or **No color** selected to skip it. See [Creating environments](https://archie.com/docs/backend/environments/creating.md).

![The Create new environment modal with the Color field showing the swatches](https://mintcdn.com/archie-e998dbf6/_-PSWtH_k72JcKHJ/images/51-env-create-modal-color.png?fit=max\&auto=format\&n=_-PSWtH_k72JcKHJ\&q=85\&s=c064aa1495027349977a5706a2633788)

## Change the color of an existing environment

You need permission to edit the backend to change a color. Without it, you don't see the color controls.

> [accordion] From the environment selector
>
> 1. Open the environment selector at the top of the Backend Console.
> 2. Hover over the environment's row. A palette button appears on the right of the row.
> 3. Click the palette button and select a swatch.
>
> The color applies as soon as you select a swatch, with no separate save step. A toast confirms **Environment color updated**.
>
> ![The color picker open next to the staging environment in the environment selector](https://mintcdn.com/archie-e998dbf6/_-PSWtH_k72JcKHJ/images/54-env-selector-row-color-picker.png?fit=max\&auto=format\&n=_-PSWtH_k72JcKHJ\&q=85\&s=abed509669c04b62d149c43ca2d6b1a9)

> [accordion] From the Environments page
>
> 1. Open the Environments page from **Manage environments** in the environment selector.
> 2. Open the **Actions** menu on the environment's row and select **Change color**.
> 3. In the **Environment color** modal, select a swatch.
> 4. Click **Save**. Click **Cancel** to close the modal without changing anything.
>
> If you select the color the environment already has, **Save** closes the modal without a change.

![The Environment color modal with the color swatches and the Cancel and Save buttons](https://mintcdn.com/archie-e998dbf6/_-PSWtH_k72JcKHJ/images/50-env-edit-color-modal.png?fit=max\&auto=format\&n=_-PSWtH_k72JcKHJ\&q=85\&s=894dd9f9f554f64b70c44bd99a616c45)

If the update fails, a toast shows the error, or **Failed to update environment color** when no message is available.

## FAQ

> [accordion] Does the color change how an environment behaves?
>
> No. The color only changes how the environment is displayed.

> [accordion] Why don't I see the palette button?
>
> Only members who can edit the backend see the color controls.

> [accordion] Why does my staging environment already have a color?
>
> Environments named `test`, `testing`, `qa`, `uat`, or `staging` default to blue, and `master` defaults to green. Pick another swatch to override the default.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.