> For the complete documentation index, see [llms.txt](https://kb.theloops.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.theloops.io/agentstudio/resource-library/how-to-guides/manage-workspaces-and-environments.md).

# Manage Workspaces and Environments

Workspaces are the top-level organizational unit in Agent Studio. This guide covers how to create a workspace and how to navigate between workspaces and environments in your day-to-day work.

#### Before You Start

* You need appropriate permissions to create workspaces in your tenant.
* Plan your workspace structure before creating. You are limited to five workspaces per tenant.
* Use clear, descriptive names and descriptions so other users understand the purpose of each workspace.

### How to Create a Workspace

{% stepper %}
{% step %}
Log in to Agent Studio.
{% endstep %}

{% step %}
Click the workspace name in the breadcrumb at the top left of any page, or click the Workspaces icon in the main navigation menu.
{% endstep %}

{% step %}
In the workspace panel, select the option to create a new workspace.
{% endstep %}

{% step %}
Enter a name for the workspace that clearly identifies the business area, site, or use case.
{% endstep %}

{% step %}
Enter a description explaining what the workspace is intended for and who manages it.
{% endstep %}

{% step %}
Save the workspace. It will appear in your workspace list immediately.
{% endstep %}
{% endstepper %}

### How to Switch Between Workspaces and Environments

The breadcrumb at the top left always shows your current workspace and environment.

* To switch workspaces: click the workspace name in the breadcrumb and select the desired workspace from the panel.
* To switch environments within a workspace: click the environment name in the breadcrumb (UAT or Production) and confirm the switch.

{% hint style="info" %}
**Reminder:** Changes to Digital Workers, including installation, configuration, and publishing, always happen in UAT. Production is read-only except for HITL configuration, model parameters, and concurrency settings.
{% endhint %}

### Key Rules

| Rule                       | Detail                                                                                          |
| -------------------------- | ----------------------------------------------------------------------------------------------- |
| All installs happen in UAT | Digital Workers can only be installed into the UAT environment, never directly into Production. |
| Changes stay in UAT        | You can only edit the Draft version of a Digital Worker, which exists in UAT.                   |
| Promotion is intentional   | Moving a Digital Worker to Production requires a deliberate publish and promote action.         |
| Maximum 5 workspaces       | Plan your workspace structure before you reach the limit.                                       |

### Workspace Planning Tips

* Create workspaces around business units, sites, or product areas that have distinct processes and data, not around individual Digital Workers or use cases within a single area.
* Document the purpose and owner of each workspace in the description field so the team knows where new Digital Workers should be installed.
* If you are close to the five-workspace limit, review whether any existing workspaces can be consolidated before creating a new one.