Docs

Environment-Level Management

View and manage secrets and variables across all environments from one interface, comparing values and spotting default versus custom overrides at a glance.

Facets provides a structured way to handle application configurations across different environments.

Multi-Environment Management

View and manage variable configurations across all environments from a single interface. The multi-environment view shows:

  • All variables defined at project or environment level
  • Current value for each environment (or indication that it's unset)
  • Status indicators showing whether each environment uses the default or a custom override
Multi-environment view listing variables with their value and override status per environment

This centralized view eliminates the need to navigate between environments to compare configurations or identify inconsistencies.


Editing Values for an Environment

Beyond comparing values across environments, you can edit many variable and secret values for a single environment in one workflow, instead of updating each one individually.

To edit values for an environment:

  1. From the multi-environment view, click Edit Env. Values.
  2. Select the environment whose values you want to update.
  3. Edit values directly in the table using Edit env value, updating one or more entries as needed.
  4. To make several changes at once, switch to the JSON editor and edit the values as raw JSON instead of using the table.
  5. Reveal secret values as needed. Secret values are fetched only when you choose to reveal them, and only for environments where you have access to view secrets.
  6. Save your changes, or discard them to revert to the values that were in place before you started editing.

Facets tracks unsaved changes while you work in this view, so you can discard them at any point before saving without affecting the existing values.

📘

Editing environment values requires a different permission than defining new variables and secrets at the project level. See the permission matrix on the Project-Level Secrets & Variables page for details.

Troubleshooting

ProblemSolution
The JSON editor shows an error and won't let you saveThe pasted JSON is invalid. Check for missing commas, unmatched brackets, or trailing commas, then correct the JSON before saving.