---
title: "Members and Roles"
description: "Invite teammates, assign roles, and manage members in a team workspace."
canonical_url: "https://docs.basicmemory.com/teams/members-and-roles"
---
# Members and Roles

> Invite teammates, assign roles, and manage members in a team workspace.

Every member of a team has a role that determines what they can do, and a status. This page is the canonical reference for both, plus the inviter's side of getting people in. Joining a team yourself? See [Joining a Team Workspace](https://docs.basicmemory.com/teams/join-a-team).

---

## Roles

<table>
<thead>
  <tr>
    <th>
      Role
    </th>
    
    <th>
      Can do
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        Viewer
      </strong>
    </td>
    
    <td>
      Read-only access to team projects and notes (can edit an <a href="https://docs.basicmemory.com/teams/team-projects">
        invite-only project
      </a>
      
       if granted edit access on it)
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Editor
      </strong>
    </td>
    
    <td>
      Read and write notes, and create projects
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        User Admin
      </strong>
    </td>
    
    <td>
      Everything an editor can, plus manage members and invitations, view the audit log, and download project archives. Assigning the role needs the Business plan
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Admin
      </strong>
    </td>
    
    <td>
      Everything a user admin can, plus manage API keys
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Owner
      </strong>
    </td>
    
    <td>
      Everything an admin can, plus manage billing, snapshots, rename the team, and transfer ownership. A team can have only one member with the Owner role.
    </td>
  </tr>
</tbody>
</table>

Once an invitation has been extended to a user, members also have a **status**:

- **Pending** — invited, but hasn't finished linking their account yet
- **Active** — accepted the invitation, with full access according to their role
- **Suspended** — only on [older seat plans](https://docs.basicmemory.com/teams/seats-and-billing#older-seat-plans): access paused because the team stayed over its seats past the 14-day grace period; reactivating is instant once a seat frees up
- **Deactivated** — removed from the team; their history is preserved and their place is released

<theme-image alt="Team members list" dark="/screenshots/cloud-app/v2-team-invite-dark.png" light="/screenshots/cloud-app/v2-team-invite-light.png">



</theme-image>

---

## Inviting members

<docs-video alt="Inviting a teammate by email, and what they see when they accept" poster="/videos/posters/docs-teams-invite.png" src="https://docs.basicmemory.com/videos/docs-teams-invite.mp4">



</docs-video>

Owners, admins, and user admins invite people by email from **Settings → Members** — click **Invite Member**.

<note>

**Invite Member is disabled at your plan's member limit.** The page shows *N members of LIMIT*, and open invitations count toward it. Upgrade under [Settings → Billing](https://docs.basicmemory.com/teams/seats-and-billing) to add more people.

</note>

<steps>

### Send an invitation

Enter the person's email address and choose a role. You can assign any role at or below your own — Owner is never an invite option.

<theme-image alt="Invite Member dialog" dark="/screenshots/cloud-app/v2-team-invitation-dark.png" light="/screenshots/cloud-app/v2-team-invitation-light.png">



</theme-image>

### They accept by email

The invitee gets an email with an accept link, signs in with the invited address, and becomes an active member. The full invitee-side walkthrough is on [Joining a Team Workspace](https://docs.basicmemory.com/teams/join-a-team).

<theme-image alt="Email invitation" dark="/screenshots/cloud-app/v2-team-accept-invite-email.png" light="/screenshots/cloud-app/v2-team-accept-invite-email.png">



</theme-image>
</steps>

<note icon="i-lucide-credit-card">

**Usage plans don't bill per person.** Cloud, Pro, and Business have a flat price with a member limit, so inviting someone changes your count, not your bill. On an [older seat plan](https://docs.basicmemory.com/teams/seats-and-billing#older-seat-plans), a seat is assigned when the invitation is claimed, not when it's sent.

</note>

---

## Managing members

From **Settings → Members**, anyone with the **User Admin** role or above can:

- **Change a member's role** — promote a viewer to editor, or vice versa. Roles can only be assigned at or below your own, and only the owner can act on another owner.
- **Deactivate a member** — removes their access and frees their place. Their authored history stays intact.
- **Reactivate a member** — restores access, if the workspace has room under its member limit.

Only the **owner** can:

- **Transfer ownership** — hand the workspace (and its subscription) to another member. The new owner takes over billing and management.
- **Rename the team.**

---

## Next Steps

<card-group>
<card icon="i-lucide-credit-card" title="Plans and Billing" to="https://docs.basicmemory.com/teams/seats-and-billing">

Plans, member limits, and credits.

</card>

<card icon="i-lucide-door-open" title="Joining a Team Workspace" to="https://docs.basicmemory.com/teams/join-a-team">

The invitee's first-day walkthrough.

</card>

<card icon="i-lucide-folder-kanban" title="Team Projects" to="https://docs.basicmemory.com/teams/team-projects">

Project access, invite-only projects, and workspace targeting.

</card>
</card-group>


## Sitemap

See the full [sitemap](https://docs.basicmemory.com/sitemap.md) for all pages.
