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

# Roles & Permissions

> Understand what owners and members can do in a team workspace.

Every member of a team workspace has one of two roles: **Owner** or **Member**. Roles control what actions a person can perform across workspace settings, tags, blocks, and spaces.

## Roles

<CardGroup cols={2}>
  <Card title="Owner" icon="crown">
    Full control over the workspace. Owners can manage settings, billing, members, tags, and all content. A workspace must always have at least one owner.
  </Card>

  <Card title="Member" icon="user">
    Has access to all Promptr features and can create and edit their own blocks and spaces. Cannot change workspace settings or invite new members by default.
  </Card>
</CardGroup>

## Permissions reference

<AccordionGroup>
  <Accordion title="Workspace settings">
    | Action                         | Owner | Member |
    | ------------------------------ | :---: | :----: |
    | View workspace settings        |   ✓   |    —   |
    | Update workspace name and logo |   ✓   |    —   |
    | Configure member permissions   |   ✓   |    —   |
    | Delete workspace               |   ✓   |    —   |
    | Leave workspace                |   ✓   |    ✓   |
  </Accordion>

  <Accordion title="Members">
    | Action                     | Owner |         Member        |
    | -------------------------- | :---: | :-------------------: |
    | View member list           |   ✓   |           ✓           |
    | Invite members (email)     |   ✓   | If permitted by owner |
    | Invite owners (email)      |   ✓   |           —           |
    | Generate invite link       |   ✓   | If permitted by owner |
    | Cancel pending invitations |   ✓   |           —           |
    | Change a member's role     |   ✓   |           —           |
    | Remove a member            |   ✓   |           —           |
  </Accordion>

  <Accordion title="Tags">
    | Action                 | Owner |                Member                |
    | ---------------------- | :---: | :----------------------------------: |
    | View tags              |   ✓   |                   ✓                  |
    | Create tags            |   ✓   | If permitted by owner (default: yes) |
    | Rename and delete tags |   ✓   |  If permitted by owner (default: no) |
  </Accordion>

  <Accordion title="Blocks and spaces">
    | Action                                           | Owner | Member |
    | ------------------------------------------------ | :---: | :----: |
    | Create blocks and spaces                         |   ✓   |    ✓   |
    | Edit own blocks and spaces                       |   ✓   |    ✓   |
    | Use shared spaces and blocks                     |   ✓   |    ✓   |
    | Access private spaces they've been added to      |   ✓   |    ✓   |
    | Access private spaces they haven't been added to |   ✓   |    —   |
  </Accordion>

  <Accordion title="Billing">
    | Action                        | Owner | Member |
    | ----------------------------- | :---: | :----: |
    | View billing information      |   ✓   |    —   |
    | Add or update payment method  |   ✓   |    —   |
    | Cancel or modify subscription |   ✓   |    —   |
    | Download invoices             |   ✓   |    —   |
  </Accordion>
</AccordionGroup>

## Owner-controlled permissions for members

Owners can extend specific capabilities to all members from **Workspace Settings → Members** (for invite permissions) and **Workspace Settings → Tags** (for tag permissions):

| Permission                       | Default | Description                                                                                                 |
| -------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------- |
| **Allow members to invite**      | Off     | Let members send email invitations to new people. Members can only invite others as members, not as owners. |
| **Allow members to create tags** | On      | Let members create new tags to organize blocks.                                                             |
| **Allow members to manage tags** | Off     | Let members rename and delete existing tags.                                                                |

## Private spaces

Spaces can be set to **private** or **shared**.

* **Shared spaces** are visible and accessible to all workspace members.
* **Private spaces** are only visible to the members who have been explicitly added to them.

Owners can always access all spaces, including private ones they haven't been added to. Members only see private spaces they've been added to.

## Changing roles

Owners can change a member's role at any time from **Workspace Settings → Members**. Click the role badge next to a member's name and select a new role from the dropdown.

<Warning>
  A workspace must always have at least one owner. You cannot demote or remove a member if they are the only owner. Assign another owner first.
</Warning>

## Leaving a workspace

Any member can leave a workspace from **Workspace Settings → General → Danger Zone**. If you are the last owner, the leave button is disabled. You must either promote another member to owner or delete the workspace before you can leave.
