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

# User Roles & Workspaces

> Manage members, roles and workspaces from the Share Of Model settings as an organisation owner.

The User Roles and Workspaces management feature lets organisation owners govern access for team members across an organisation and its workspaces.

From the platform, organisation owners can:

* assign roles at the **organisation level** (for cross-workspace access),
* set granular permissions at the **workspace level**,
* create workspaces and allocate **credits** per workspace.

## Key terms

| Term              | Definition                                                           |
| ----------------- | -------------------------------------------------------------------- |
| **Organization**  | The higher-level account for a company or holding.                   |
| **Workspace**     | Sub-level environment within an organisation (e.g. brands or teams). |
| **Role**          | Defines a user's permissions (Viewer, Editor, Owner).                |
| **Admin / Owner** | Primary user able to manage roles, workspaces and members.           |

## User roles

### Organisation-level roles

Apply across all workspaces in the organisation.

| Role                    | Permissions                                                 |
| ----------------------- | ----------------------------------------------------------- |
| **Organization Guest**  | No special org permissions — set permissions per workspace. |
| **Organization Viewer** | View all workspaces and analyses.                           |
| **Organization Editor** | View and create analyses across all workspaces.             |
| **Organization Owner**  | Administer the organisation and its workspaces.             |

### Workspace-level roles

Apply to a single workspace.

| Role                 | Permissions                                    |
| -------------------- | ---------------------------------------------- |
| **Workspace Viewer** | View analyses within the workspace.            |
| **Workspace Editor** | Create and view analyses within the workspace. |

## Step-by-step

<Steps>
  <Step title="Open Settings">
    Log in, click your initials in the top-right corner, then click **Settings** to manage users and roles.

    <Frame caption="Open the Settings panel">
      <img src="https://mintcdn.com/jellyfish/MmUm2_YE5Jn6SqTt/images/platform/getting-started/Setting-section-ccad2619.png?fit=max&auto=format&n=MmUm2_YE5Jn6SqTt&q=85&s=20a466a4ebb17ec8291d51e9312d1b3b" alt="Settings entry" width="526" height="485" data-path="images/platform/getting-started/Setting-section-ccad2619.png" />
    </Frame>

    Settings exposes two main sections: **Workspaces** and **Members**.
  </Step>

  <Step title="Invite a new member">
    From **Members**, click **+ Invite**, enter the user's email, and pick an organisation role (Guest, Viewer, Editor, Owner).

    <Frame caption="Invite a member">
      <img src="https://mintcdn.com/jellyfish/MmUm2_YE5Jn6SqTt/images/platform/getting-started/Screenshot-2026-05-05-at-15_08_26-0d7113b7.png?fit=max&auto=format&n=MmUm2_YE5Jn6SqTt&q=85&s=09e7fe8b125b0d4da9200a5d768df3fa" alt="Invite member" width="1610" height="990" data-path="images/platform/getting-started/Screenshot-2026-05-05-at-15_08_26-0d7113b7.png" />
    </Frame>

    <Note>
      New emails receive a welcome email. Existing **Guest** users are granted access without an email notification.
    </Note>
  </Step>

  <Step title="Manage roles for existing users">
    From **Members**, view all users with their organisation role. Select a user to update their role (e.g. Editor → Viewer) or remove them.

    <Frame caption="Manage existing users">
      <img src="https://mintcdn.com/jellyfish/MmUm2_YE5Jn6SqTt/images/platform/getting-started/Screenshot-2026-05-05-at-15_15_41-e8450427.png?fit=max&auto=format&n=MmUm2_YE5Jn6SqTt&q=85&s=5b44cae6373f8f4eced255b6309c8e97" alt="Manage users" width="2360" height="1300" data-path="images/platform/getting-started/Screenshot-2026-05-05-at-15_15_41-e8450427.png" />
    </Frame>
  </Step>

  <Step title="Create and manage workspaces">
    Open the **Workspaces** list.

    <Note>
      New workspace creation is only available on the **Enterprise** plan. The Pro plan ships with a single workspace.
    </Note>

    Assign a workspace name and a credit limit. Credits allocated at the organisation level can be distributed across workspaces as you see fit.

    <Frame caption="Create a workspace">
      <img src="https://mintcdn.com/jellyfish/MmUm2_YE5Jn6SqTt/images/platform/getting-started/Screenshot-2026-05-05-at-15_10_14-aa744b6e.png?fit=max&auto=format&n=MmUm2_YE5Jn6SqTt&q=85&s=ebebd6679acf9a0bdea6304524ed9be0" alt="Create workspace" width="2334" height="1300" data-path="images/platform/getting-started/Screenshot-2026-05-05-at-15_10_14-aa744b6e.png" />
    </Frame>
  </Step>

  <Step title="Add users to a workspace">
    Click **Invite Member**, enter the email, then assign a workspace role (Viewer or Editor).

    <Frame caption="Invite to workspace">
      <img src="https://mintcdn.com/jellyfish/MmUm2_YE5Jn6SqTt/images/platform/getting-started/Screenshot-2026-05-05-at-15_10_58-e0931785.png?fit=max&auto=format&n=MmUm2_YE5Jn6SqTt&q=85&s=2fff3c0d6e85e29be719036035b4a767" alt="Invite to workspace" width="1828" height="1100" data-path="images/platform/getting-started/Screenshot-2026-05-05-at-15_10_58-e0931785.png" />
    </Frame>
  </Step>

  <Step title="Manage workspace permissions">
    Update permissions for users with an organisation role of **Guest** within the workspace.

    <Frame caption="Manage workspace permissions">
      <img src="https://mintcdn.com/jellyfish/MmUm2_YE5Jn6SqTt/images/platform/getting-started/Screenshot-2026-05-05-at-15_13_20-6f11eda5.png?fit=max&auto=format&n=MmUm2_YE5Jn6SqTt&q=85&s=f03c6ed1e2ca43021e7548f09a207ad2" alt="Workspace permissions" width="2368" height="1286" data-path="images/platform/getting-started/Screenshot-2026-05-05-at-15_13_20-6f11eda5.png" />
    </Frame>
  </Step>
</Steps>

## What's next

<CardGroup cols={2}>
  <Card title="API Keys" icon="key" href="/platform/getting-started/creating-and-managing-api-keys">
    Issue and manage API keys for integrations.
  </Card>

  <Card title="Credit System" icon="coins" href="/platform/getting-started/understanding-the-credit-system-for-share-of-model">
    Understand how usage is metered.
  </Card>
</CardGroup>
