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

# Use workspaces to collaborate with your team in Paige

> Workspaces let your team share access to Paige projects. Invite members by email, assign roles, transfer projects, and manage your team — all in one place.

A workspace is a shared environment where you and your team can collaborate on Paige projects. Instead of each person working in isolation on their own account, a workspace gives everyone on your team a common home — with role-based access so you control who can do what. Projects inside a workspace are accessible to all members with the appropriate permissions.

## Create a workspace

<Steps>
  <Step title="Open Workspaces">
    From the Paige dashboard, click **Workspaces** in the top navigation or sidebar.
  </Step>

  <Step title="Create a new workspace">
    Click **New workspace**, give it a name, and confirm. You become the owner of the workspace automatically.
  </Step>
</Steps>

## Invite team members

<Steps>
  <Step title="Go to workspace settings">
    Open your workspace and click **Settings**, then navigate to the **Members** tab.
  </Step>

  <Step title="Send an invitation">
    Enter the email address of the person you want to invite and select the role you want them to have. Click **Send invite**.
  </Step>

  <Step title="Wait for them to accept">
    The invitee receives an email with a link to join the workspace. Once they accept, they appear in your member list with the role you assigned.
  </Step>
</Steps>

<Info>
  You can view and cancel pending invitations from the **Members** tab at any time.
</Info>

### How invitees land in your workspace

When someone accepts an invitation:

* If the invitee already has a Paige account, the workspace shows up the next time they log in.
* If the invitee is new, the invitation link signs them up and verifies their email. After verification they're routed **directly into your workspace** with access to the projects you've shared — no separate personal project is created.
* If their invitation link has expired but the invite itself is still pending, Paige holds them on the verification step and reuses the pending invite so they still end up in the right workspace.

## Member roles

Roles define what each member can see and do within a workspace.

<AccordionGroup>
  <Accordion title="Owner">
    The owner has full control over the workspace — managing members, updating settings, transferring projects, and deleting the workspace. Each workspace has exactly one owner. The owner can transfer ownership to another member.
  </Accordion>

  <Accordion title="Admin">
    Admins can invite and remove members, manage projects within the workspace, and update workspace settings. They cannot delete the workspace or transfer ownership.
  </Accordion>

  <Accordion title="Member">
    Members have access to the projects shared within the workspace. Their specific abilities within a project depend on the permissions assigned to them. Members cannot manage other members or change workspace settings.
  </Accordion>
</AccordionGroup>

<Tip>
  Use the admin role for trusted collaborators who need to manage the team, and the member role for contributors who should only work on projects.
</Tip>

## Transfer a project to a workspace

If you have a project on your personal account that you want to share with your team, you can move it into a workspace.

<Steps>
  <Step title="Open the project">
    From the dashboard, open the project you want to transfer.
  </Step>

  <Step title="Go to project settings">
    Click **Settings** in the project sidebar.
  </Step>

  <Step title="Transfer to workspace">
    Find the **Transfer project** option and select the workspace to transfer it to. Confirm the transfer.
  </Step>
</Steps>

<Warning>
  Once a project is transferred to a workspace, all workspace members with appropriate permissions can access it. Make sure you're transferring to the right workspace.
</Warning>

## Manage your workspace

<CardGroup cols={2}>
  <Card title="Update member roles" icon="user-cog">
    Go to **Settings → Members**, click the role next to a member's name, and select a new role.
  </Card>

  <Card title="Remove a member" icon="user-minus">
    In the **Members** tab, find the member you want to remove and click **Remove**. They lose access immediately.
  </Card>

  <Card title="Transfer ownership" icon="arrow-right-left">
    Owners can hand off ownership to another member from **Settings → General**. You become an admin after transferring.
  </Card>

  <Card title="Leave a workspace" icon="log-out">
    Go to **Settings → Members**, scroll to your own entry, and click **Leave workspace**. You'll lose access unless re-invited.
  </Card>
</CardGroup>

<Note>
  If you are the owner and want to leave a workspace, you must transfer ownership to another member first.
</Note>