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

# Organization Hierarchy

> How organizations, workspaces and teams fit together, and how to plan your structure

48° organizes people in three levels: **organization → workspace → team**. Every member belongs to an organization. Workspaces divide the organization into areas such as departments, and teams are smaller groups inside a workspace. The structure decides who can see shared assistants, prompt templates, toolsets and skills, and which role a member has where.

![Workspaces](https://mintcdn.com/blackmountaingmbh/XFag3CE4nO-WN3UD/images/screens/en/admin/workspaces.png?fit=max\&auto=format\&n=XFag3CE4nO-WN3UD\&q=85\&s=e4f92b64818fb9159675ebb09670338d)

## The three levels

| Level | What it represents | Contains |
| - | - | - |
| **Organization** | Your company. Billing, seats, branding, integrations and model settings live here. | Workspaces, members |
| **Workspace** | An area of the organization, for example a department, business unit or client. | Teams, workspace members |
| **Team** | A group of people who work together, for example a project team. | Team members |

Each level has its own member list, and each membership carries a role: **Owner**, **Manager** or **Viewer**. See [Roles and permissions](https://docs.blackmountain.io/admin/organization/roles-and-permissions.md).

## How membership flows down

A member's organization role also applies in every workspace and team of that organization, unless they have a direct role there. The same is true one level down: a workspace role applies to all teams in that workspace.

* A Manager of the organization acts as a Manager in every workspace and team.
* If you give that person a direct Viewer role in one workspace, Viewer applies in that workspace and its teams instead.
* Adding someone to a team automatically adds them to the parent workspace and organization as a Viewer if they aren't a member yet.

## How the hierarchy controls sharing

Assistants, prompt templates and toolsets can be private or shared with a team, a workspace or the whole organization. Everyone in the chosen scope can use them, including Viewers. Skills can be private or shared with a team.

| Shared with | Who can use it |
| - | - |
| **Private** | Only the creator |
| **Team** | Members of that team |
| **Workspace** | Members of that workspace and its teams |
| **Organization** | Every member of the organization |

See [Visibility and governance](https://docs.blackmountain.io/admin/assistants-skills/governance.md) for who can share and edit at each scope.

## Each level has its own AI context

Organizations, workspaces and teams each have an **AI Context** field. Use it to describe your industry, products, ways of working or tone. Assistants can look up this context during a chat when a question is about your organization, workspace or team. See [Company context](https://docs.blackmountain.io/chat/tools/company-context.md).

## Plan your structure

**1. Start with one organization**

Most companies need a single organization. Create a second one only for a truly separate entity, such as a subsidiary with its own billing.

**2. Add workspaces for large areas**

Create a workspace per department or business unit, for example Sales, Engineering and Operations.

**3. Add teams for day-to-day groups**

Create teams for the groups that share assistants and prompts every day.

**4. Give roles at the highest level that fits**

Give organization-wide roles to the few people who run 48° for everyone. Give Manager roles at workspace or team level to the people who look after one area.

> [!TIP]
>
> Keep the structure flat. Two or three workspaces with a few teams each are easier to govern than a deep tree.

## Where to manage it

Open the profile menu in the sidebar and select **Workspace Settings**. The **Organization** section has pages for **Organization**, **Workspaces**, **Teams** and **Members**. All pages act on the organization that is currently selected in the sidebar.

## Related

> [card] [Roles and permissions](https://docs.blackmountain.io/admin/organization/roles-and-permissions.md)
>
> What Owners, Managers and Viewers can do at each level.

> [card] [Manage workspaces and teams](https://docs.blackmountain.io/admin/organization/managing.md)
>
> Create, edit and delete workspaces and teams.

> [card] [Invite members](https://docs.blackmountain.io/admin/organization/inviting-members.md)
>
> Bring people into your organization.

> [card] [Organizations, workspaces and teams](https://docs.blackmountain.io/get-started/organizations-workspaces-teams.md)
>
> The member's view of the hierarchy.


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