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

# Secret mappings

> Map vault secrets to destination keys on environment instances, deploy one mapping or a whole vault, and track each mapping's last deploy and status.

**Mappings** (`/platform/environments/mappings`) holds the fan-out mappings from vault secrets to runtime deployment targets. The page header reads **Environments**. It is the **Mappings** tab of the **Secrets** tab group, after **Vaults**, **Connections**, and **Instances**; Secrets opens from the **Secrets** tab of **Settings** under **Platform**. Open it to send a secret to a deployment as an environment variable, or to see whether the last deploy succeeded.

![Secret mappings (light)](https://mintcdn.com/gloo-b243725a/xyq5perq6SLByPBn/forge/images/console/platform/environment-mappings-light.png?fit=max\&auto=format\&n=xyq5perq6SLByPBn\&q=85\&s=be2a836bbdbbcad3a5a21911ea792e4e)

Secret mappings — Forge Console at `/platform/environments/mappings`

## What you can do

* **Filter by Vault** (default **All Vaults**). Mappings appear only once a vault is selected; the choice is kept in the URL as `?vault=`.
* **+ Add Mapping** opens the mapping form: a vault secret, an instance, and the destination key it deploys as.
* **Deploy All** (shown once a vault is selected) deploys every mapping in that vault.
* **Deploy** on a row deploys that one mapping.
* The row menu offers **Edit** and **Delete**. **Delete** asks for confirmation; the secret no longer deploys to that instance.

## Columns

| Column | Shows |
| - | - |
| **Vault** | The vault that holds the secret |
| **Secret** | The secret being deployed |
| **Instance** | The target environment instance |
| **Destination Key** | The environment variable key on the target |
| **Last Deployed** | When the mapping last deployed |
| **Actions** | **Deploy** and the row menu |

## Deploy status

A row's deploy status is `idle`, `pending`, `success`, or `failed`, shown as an icon next to **Deploy**. A failed deploy shows its error, or "Deploy failed.".

## Who can act

* Viewing requires `vaults:read`; **+ Add Mapping** appears only with `vaults:manage`.
* **Deploy** also requires membership in the target instance. Without it, the button stays disabled with "Membership required. Go to Instances → ⋮ → Manage members to grant deploy access."

> [!NOTE]
>
> Without `vaults:read` the page says "You need the secret\_mappings:read permission to view Mappings." The permission it checks is `vaults:read`.

## Key state to watch

* `failed` on a row: the secret did not reach the instance. Read the error, fix the instance connection or the key, then **Deploy** again.
* "Mapping references a deleted resource — remove this mapping to clean up.": the secret or instance is gone; delete the mapping.
* A disabled **Deploy** with "Membership required": add yourself on [Instances](https://docs.gloo.com/forge/console/platform/environment-instances.md) through **Manage Members**.
* A **Last Deployed** date older than the secret's latest rotation: deploy the mapping so the target receives the current version.

## Related surfaces

* [Vaults](https://docs.gloo.com/forge/console/platform/vaults)
* [Environments](https://docs.gloo.com/forge/console/platform/environments.md)
* [Instances](https://docs.gloo.com/forge/console/platform/environment-instances.md)


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