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

# Organisation

> Manage multi-tenant workspaces, invite team members, and control access with role-based permissions

Organisations in OpenLIT let you group team members under a shared workspace. Each organisation contains one or more projects, and each project owns its own ClickHouse database configuration. Resources such as dashboards, prompts, rules, contexts, and secrets are scoped through the selected organisation and project, giving teams isolation without forcing every workspace to become a separate organisation.

## Key features

* **Workspace isolation**: Each organisation maintains its own database configuration and resource space.
* **Project hierarchy**: Projects sit inside organisations and group database configurations for different environments, teams, or workloads.
* **Role-based access control**: Assign **Admin** or **Member** roles to control who can manage settings and invite others.
* **Email invitations**: Invite teammates by email. Invitations can be accepted or declined from the notification panel.
* **Multiple organisations**: A single user can belong to multiple organisations and switch between them at any time.
* **Member management**: Admins can view all members, update roles, and remove users from the organisation.

## Get started

<Steps>
  <Step title="Create an organisation">
    Set up your first workspace in minutes.

    1. Navigate to **Settings → Organisation** in OpenLIT.
    2. Click **Create Organisation**.
    3. Enter a name for your organisation and confirm.

    Your new organisation is created and set as the active workspace.
  </Step>

  <Step title="Invite team members">
    Bring your team into the workspace.

    1. Go to **Settings → Organisation → Members**.
    2. Click **Invite Members**.
    3. Enter one or more email addresses and select a role (**Admin** or **Member**).
    4. Click **Send Invites**.

    Invited users receive an email with a link to accept and join the organisation.
  </Step>

  <Step title="Create a project">
    Add a project when an organisation needs separate database configuration boundaries.

    1. Navigate to **Settings → Organisation → Projects**.
    2. Enter a project name.
    3. Click **Create project**.

    New projects appear in the project dropdown in the top navigation bar.
  </Step>

  <Step title="Switch projects">
    Projects control which database configuration is active.

    1. Use the project dropdown in the top navigation bar.
    2. Select the project you want to work in.
    3. Open **Settings → Organisation** to manage the project's database configuration.

    Database configuration lists update to match the selected project.
  </Step>

  <Step title="Accept an invitation">
    When you receive an invitation:

    1. Open the link in the invitation email or log in to OpenLIT.
    2. A notification will show the pending invitation.
    3. Click **Accept** to join, or **Decline** to dismiss.

    Once accepted, the organisation appears in your workspace switcher.
  </Step>

  <Step title="Manage members and roles">
    Admins have full control over member management.

    1. Navigate to **Settings → Organisation → Members**.
    2. View all active members and pending invitations.
    3. Change a member's role between **Admin** and **Member** using the role dropdown.
    4. Remove a member by clicking the remove icon next to their name.
    5. Cancel a pending invitation by clicking **Cancel** next to the invite.
  </Step>

  <Step title="Switch organisations">
    If you belong to multiple organisations:

    1. Click the organisation name in the top navigation bar.
    2. Select the organisation you want to switch to from the dropdown.

    All resources update to reflect the selected organisation's data.
  </Step>
</Steps>

## Roles and permissions

| Action                           | Admin | Member |
| -------------------------------- | ----- | ------ |
| View dashboards, traces, prompts | ✅     | ✅      |
| Create / edit resources          | ✅     | ✅      |
| Invite members                   | ✅     | ❌      |
| Change member roles              | ✅     | ❌      |
| Remove members                   | ✅     | ❌      |
| Delete organisation              | ✅     | ❌      |
| Manage database configuration    | ✅     | ❌      |
| Create and switch projects       | ✅     | ✅      |

## Project hierarchy

OpenLIT uses the following hierarchy:

```text theme={null}
Organisation
  Project
    Database configuration
```

Use organisations for account and membership boundaries. Use projects for separate database configuration boundaries inside the same organisation, such as production, staging, customer-specific workspaces, or different teams sharing the same membership model.

Every organisation has a default project. Existing organisations are mapped to a default project so database configurations continue to work after upgrading.

***

<CardGroup cols={3}>
  <Card title="Manage LLM secrets" href="/latest/openlit/developer-resources/vault/overview" icon="book">
    Centrally store LLM API keys that applications can retrieve remotely without restarts
  </Card>

  <Card title="Manage prompts" href="/latest/openlit/prompts-experiments/prompt-hub/overview" icon="shapes">
    Version, deploy, and collaborate on prompts with centralized management and tracking
  </Card>

  <Card title="Multiple databases" href="/latest/openlit/developer-resources/multiple-db" icon="database">
    Connect and switch between multiple ClickHouse database configurations
  </Card>
</CardGroup>