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

# What is a workspace

> Learn what a workspace is and how it organizes people, content, and settings in Oculon.

A workspace is the top-level environment where your team uses Oculon. It brings together people, permissions, planning assets, and shared settings so work happens in one governed place instead of across disconnected files.

## What lives in a workspace

A workspace usually includes:

* **People with access levels**: Collaboration is managed via **Workspace Owners** (full admin control) and **Members**.
* **Shared Teamspaces**: Organized areas where teams can manage models, databases, and boards collectively.
* **Planning Assets**: Shared models, databases, and views that are accessible to the team.
* **Workspace Settings**: Global settings for data access, integrations, and organizational preferences.

## Switching between workspaces

### Why switch?

Users often belong to multiple workspaces to manage different business units, distinct client projects, or separate testing environments. Switching workspaces allows you to jump between these isolated contexts using a single login.

### How to switch

You can easily switch between your active workspaces from the profile menu:

![](https://mintcdn.com/oculon/Bbx9Cjtl1NMkgTLb/images/getting-started/fr-switch-workspace.png?fit=max\&auto=format\&n=Bbx9Cjtl1NMkgTLb\&q=85\&s=f93a4f1979d2ce3b1bb6678d0c3b6066)

1. Click on your **profile icon** in the bottom-left corner of the navigation bar.
2. Select **Switch Workspace** from the menu options.
3. Choose the target workspace from your list of available environments.

> You can create a new workspace by clicking the **+** icon in the right corner of the **Workspaces** list.

## Why the workspace matters

The workspace is the frame around everything else. It determines who can join, what they can see, and how content is organized. If the workspace is set up well, navigation and collaboration both become easier.

## How to think about it

If a model is where planning logic lives, the workspace is where planning operates. It is the shared environment that makes that logic usable across a team.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.