> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://humanloop.com/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://humanloop.com/docs/_mcp/server.

> Environments are a tagging system for deploying Prompts. They enable you to deploy maintain a streamlined deployment workflow and keep track of different versions of Prompts.

[Environments](/docs/explanation/environments) are a tagging system for deploying Prompts. They enable you to deploy maintain a streamlined deployment workflow and keep track of different versions of Prompts.

The default environment is your production environment. Everytime you fetch a Prompt, Tool, Dataset etc. without specifying an alternative environment or specific version, the version that is tagged with the default environment is returned.

## Create an environment

### Go to your [Environments](https://app.humanloop.com/account/environments) tab in your Organization's settings.

### Click the '**+ Environment**' button to open the new environment dialog

### Assign a custom name to the environment

We recommend something short. For example, you could use `staging`, `prod`, `qa`, `dev`, `testing`, etc. This name is be used to identify the environment in the UI and in the API.

### Click **Create**.

![](/docs/_fern-img/f40b0fad588834bcea0b552d447d82e5e7d760605be67ed299e6c1032a31e5a7.webp)

## Rename an environment

You can rename an environment to re-arrange your development workflows. Since each new file is automatically deployed to the default environment, which is production unless altered, it may make more sense to create a separate production environment and rename your current environments.

> **This may break production systems**
>
> Renaming the environments will take immediate effect, so ensure that this
> change is planned and does not disrupt your production workflows.

### Go to environments page

Go to your Organization's **[environments page](https://app.humanloop.com/account/environments)**.

### Identify the environment

Find the environment you wish to rename.

### Click 'Rename'

Click the three dots button on the right of its row to open its menu.
Click **Rename**.
A confirmation dialog will be displayed. Update the name and click **Rename**.

![](/docs/_fern-img/f40b0fad588834bcea0b552d447d82e5e7d760605be67ed299e6c1032a31e5a7.webp)