> For the complete documentation index, see [llms.txt](https://docs.ratl.ai/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ratl.ai/guide/manage-account/organizations-and-workspaces.md).

# Organizations and Workspaces

### Organization

An **Organization** is the top-level container for your account.

* When you sign up, you get your **own Organization** by default.
* This ensures **data isolation** so your work stays separated from other users and organizations.

***

### Workspace

A **Workspace** is an **isolated space** where your testing data lives, including:

* test executions (runs)
* reports and results
* execution history
* run artifacts (like videos, where supported)

Workspaces help you keep testing data organized across different apps, environments, or teams.

***

### Default starter workspace

When you sign up, ratl.ai Studio automatically creates a **starter workspace** for you so you can begin running tests immediately.

You can continue using it, or create additional workspaces as needed.

***

### Creating a workspace

You can create a workspace from either of these places:

#### Option 1: From Settings

1. Open **Settings**
2. Go to the **Workspaces** section
3. Click the **Add New** button
4. Enter a workspace name (follow naming rules below)
5. Create the workspace and switch to the new workspace if needed\
   \
   ![](/files/2PgaCW9uCGctL9jrINdN)    ![](/files/HW3Nmcy8WQPsBihzsceN)   \
   \ <img src="/files/YWooAyU9MZx7d3tQr1La" alt="" data-size="original">

#### Option 2: From the Sidebar

1. Open the **Sidebar**
2. Find the **Workspace** section / switcher at the top of the sidebar below the logo
3. Click on it to expand the dropdown
4. Click **Create Workspace**
5. Enter a workspace name (follow naming rules below)
6. Create the workspace and switch to the new workspace if needed

<div align="left"><figure><img src="/files/jpTVOrN8qZxYyM1AftJq" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="/files/Eufa5Qg8vdcv9174NzxW" alt="" width="375"><figcaption></figcaption></figure></div>

***

### Workspace naming rules

Workspace names must follow these rules:

#### 1) Workspace name must be unique

Your workspace name must be **unique**.

If your preferred name is taken, add a clear suffix like:

* `myapp-staging`
* `myapp-qa`
* `myapp-2026`

#### 2) No special characters

Workspace names must **not** contain special characters like:

* `@` `#` `$`

To keep naming predictable, avoid symbols in general.

#### 3) Only hyphens are allowed as separators

If your workspace name has multiple words, use **hyphens (`-`)**.

✅ Valid examples:

* `acme-web`
* `acme-checkout`
* `web-tests-staging`
* `ratl-studio-demo`

❌ Invalid examples:

* `acme@web`
* `acme#checkout`
* `acme$prod`
* `acme_web`

***

### Recommended workspace structure

To keep things clean as your execution history grows, most teams create workspaces by:

#### By environment

* `myapp-dev`
* `myapp-staging`
* `myapp-prod`

#### By product area

* `myapp-auth`
* `myapp-checkout`
* `myapp-search`

Choose a pattern early and stay consistent — workspace naming becomes hard to clean up once lots of runs are stored.

***

#### Where can I access my workspaces?

You can always find workspaces from:

* **Settings → Workspaces**
* the **Sidebar workspace switcher**

***

### Summary

* Your account includes an **Organization** to keep data isolated.
* A **Workspace** is an isolated space where your test execution data is stored.
* A **starter workspace is created automatically** when you sign up.
* You can create new workspaces from **Settings** or the **Sidebar**.
* Workspace names must be **unique**, contain **no special characters**, and use **hyphens only**.