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

# Members and roles

> Invite teammates to your workspace and control what each role can do.

Manage workspace access at **Settings → Members & roles**. Teammates join an existing workspace through invitations. Anyone can sign up at [moda.dev/signup](https://moda.dev/signup), but a new workspace is only created once the Moda team approves the request.

## Roles

Every member has one of three roles:

| Role | Summary |
| - | - |
| Viewer | Read-only access to the dashboard. The default role for invitations. |
| Admin | Everything a viewer can do, plus workspace management: keys, members, integrations, and workspace settings. |
| Owner | Everything an admin can do, plus promoting members to admin and transferring ownership. |

What each action requires:

| Action | Viewer | Admin | Owner |
| - | - | - | - |
| View traces, signals, problems, and other dashboard data | Yes | Yes | Yes |
| View the ingestion-key list | Yes | Yes | Yes |
| Create and revoke ingestion keys | — | Yes | Yes |
| Invite members and cancel pending invitations | — | Yes | Yes |
| Change a member's role to Viewer | — | Yes | Yes |
| Promote a member to Admin | — | — | Yes |
| Remove a member | — | Yes | Yes |
| Rename the workspace | — | Yes | Yes |
| Adjust the CLI key limit | — | Yes | Yes |
| Transfer ownership | — | — | Yes |

The owner's role cannot be changed and the owner cannot be removed; ownership moves only through a transfer.

## Inviting a member

<Steps>
  <Step title="Open the invite dialog">
    In **Settings → Members & roles**, click **Invite member**. Requires the admin or owner role.
  </Step>

  <Step title="Enter the email and role">
    Choose **Viewer** (read-only access, the default) or **Admin** (can manage settings and invite members). Invitations cannot grant the Owner role.
  </Step>

  <Step title="Send and track">
    The invitation appears under pending invitations, where it can be cancelled or resent. It expires after 7 days. If the email cannot be sent, Settings shows an error and keeps the invitation available under **Pending invitations**. Click **Resend email** to try again; there is no need to cancel and recreate it.
  </Step>

  <Step title="The invitee accepts">
    The invitee opens the invitation link, accepts, and lands in the workspace with the assigned role.
  </Step>
</Steps>

<Note>
  Invitations work for both new and existing Moda accounts. The recipient must sign in with the invited email address. If they already belong to this workspace, the invite dialog tells you that they are already a member.
</Note>

## Changing roles and removing members

Admins and owners manage membership from the member list:

* Change any non-owner member's role. Only the owner can promote a member to Admin; admins can set members to Viewer.
* Remove any non-owner member. You cannot change your own role or remove yourself.

## Transferring ownership

Only the owner can transfer ownership. In the member list, set another member's role to **Owner**; a confirmation dialog completes the transfer. After the transfer, the previous owner becomes an Admin and can no longer transfer ownership.

## Next steps

* [Authentication](/administration/authentication) — the key management actions these roles gate.
* [Limits](/administration/limits) — the CLI key limit admins can adjust.
* [Quickstart](/quickstart) — get data flowing once your team has access.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.