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

# Environments

> Define an org-level branching strategy with per-stage deployment pipelines for your agents.

Environments is an org-level branching strategy where you define the steps required before an agent can be deployed to a particular stage. Each environment corresponds to a branch (for example, `nonprod`, `preprod`, `prod`) and has its own pipeline of steps that must be completed before an agent is considered ready for that stage.

This keeps production deployments separated from development, gives teams visibility into what stage each agent version is at, and ensures the right checks happen before an agent reaches real users.

<img src="https://mintcdn.com/lyzrinc/KL0td225zOmlZ1fc/assets/images/studio/new-environments.png?fit=max&auto=format&n=KL0td225zOmlZ1fc&q=85&s=32ecff0f7bfcb8d5e214a060e0f479f6" alt="Screenshot of the Environments page in Lyzr Studio showing three environments: Non-prod (nonprod, 16 steps), Pre-prod (preprod, 16 steps), and Prod (prod, 8 steps), each with an Open pipeline button." width="2446" height="926" data-path="assets/images/studio/new-environments.png" />

## Creating an environment

1. Go to **Control Plane > Environments**.
2. Select **Add branch** to create a new environment.
3. Give the environment a name and branch identifier.
4. Select **Save**.
5. Select **Open pipeline** on the new environment to define the steps and approval gates for that stage.

## Pipelines

Each environment has a pipeline that defines what must happen before an agent version is promoted to that branch. Pipelines are configured in the Approval Flows view. See [Approval Flows](../governance/approval-flows) for how to set up gates, required approvals, reviewers, and merge rules.

## Environment ordering

Environments are displayed left to right in the order of promotion. An agent version typically moves from the leftmost environment (development) to the rightmost (production) after passing the required steps and approvals at each gate.

## Next steps

* [Approval Flows](../governance/approval-flows)
* [Version Control](version-control)
