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

# Workspaces overview

A workspace is the top-level operational boundary in Unitlab. It contains members, roles, projects, Data Space, datasets, ontologies, models, releases, storage configuration, and subscription or quota context.

{% hint style="info" %}
**Use this area when:** you are creating an environment, separating organizations or programs, managing shared resources, or governing access and capacity.
{% endhint %}

### How this area fits into production

```mermaid
flowchart TB
  A["Workspace"]
  B["Members + roles"]
  C["Data + datasets"]
  D["Projects + workflows"]
  E["Ontologies + models"]
  F["Releases + settings"]
  A --> B
  A --> C
  A --> D
  A --> E
  A --> F
```

![Workspace switcher open from the Unitlab sidebar](https://292810646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGjVLUz4wthGkGlRKM6rM%2Fuploads%2F4jGdNCVAjx3AXBzWerLu%2Fworkspace-switcher.png?alt=media\&token=3874b3f5-b671-44c8-aefe-4851e9d06723)

*The workspace switcher is the boundary selector for projects, Data Space, datasets, models, members, releases, and settings. The item count beside each workspace helps confirm context before entry; New Workspace starts a separate boundary.*

### What this area controls

The workspace area includes:

* workspace list and switcher;
* general settings for name, purpose, and logo;
* account security and 2FA;
* billing and pricing portal;
* usage and quota visibility;
* members and member statistics;
* Roles & Permissions editor;
* API keys;
* cloud storage connections;
* user profile.

Usage can report datasource, image, video, medical, token, audio-duration, AI-inference, and member consumption. The interface warns when a downgraded plan would be exceeded.

Workspace destruction is intentionally different from leaving a workspace. It is Owner-only, requires the exact workspace name, and requires a second factor when the Owner has 2FA.

### Start with the right page

| Decision                    | Production guidance                                  |
| --------------------------- | ---------------------------------------------------- |
| Create or enter a workspace | Use workspace creation and switching.                |
| Manage shared configuration | Use workspace settings.                              |
| Control people              | Use members, roles, and permission groups.           |
| Control source connections  | Use storage and cloud settings.                      |
| Plan capacity               | Review quotas, subscription, and operational limits. |
| Review governance           | Run periodic workspace operations and access review. |

### Operating boundary

* Use separate workspaces when identity, ownership, data policy, or administrative control must be isolated.
* Project permissions do not replace workspace governance.
* Workspace settings changes can affect every project and integration in the boundary.

### A production-ready handoff

The workspace has accountable owners, a defined purpose, approved membership, resource naming standards, shared configuration ownership, capacity monitoring, and an offboarding process.