# Roles and permissions

Every member of your organization has one role, and the role decides what they can do. This page
lists every built-in role and every permission it grants, side by side, so you can choose the
right role for someone or find out why a button is missing. The tables come straight from
Productmind's role definitions, and use the same names as the **Roles** tab.

<Availability permission="In the app, the Owner and Admin roles see your organization's roles: choose Identity & Access, then Roles." />

## Reading the tables

A permission is named by its row and its column, the way the **Roles** tab's grid names it:
**Tasks: Update** is the **Update** column of the **Tasks** row. The rest of this guide names
permissions the same way.

- **All** means **Create**, **Read**, **Update** and **Delete**.
- **-** means none.
- **Chat** is a single switch rather than four columns, written **Chat: Enabled** in this guide.
  **Enabled** lets a role start chats and send messages. The **Viewer** and **Customer** roles show
  **Disabled**, and can still read conversations.

These are the built-in roles as Productmind defines them. Your organization may have
**Customized** versions of some of them, or **Custom** roles of its own: the **Roles** tab shows
what your organization's roles really allow. See
[Roles](/user-guide/settings/identity-and-access/roles).

## The built-in roles

<RoleGrants show="roles" />

## Permissions on your product work

<RoleGrants show="grid" />

The groups are the **Roles** tab's:
- **Core work** is the records you work on.
- **Collaboration** applies across those records: comments, logs, decisions, attachments and tags
  on features, tasks, sessions and the rest.
- **Workspace resources** is everything else in a workspace.

**Automations** and **Internal meetings** are being rolled out gradually. If they aren't enabled
for your organization, their rows don't appear on your **Roles** tab.

**Marketing** is the permission for your customer release notes, blog posts and customer emails.
**Read** sees Marketing, the notes, the blog posts and their published and approved versions, and
the customer emails and their send log. **Update** drafts, redrafts and edits a
release's notes, blog posts and customer emails. **Create** publishes the notes,
approves blog posts and sends customer emails. **Delete** deletes blog posts. Customer emails also
need **Contacts: Read**, because they show your contacts' email addresses.
The **Owner**, **Admin**, **Power User** and **Product Manager** roles hold all of it, and
**Developer**, **Viewer** and **Customer** hold none. **Custom** roles, and **Customized** versions
of a built-in role, don't get it automatically: contact Productmind support to add it. See
[Marketing](/user-guide/product/marketing#permissions).

## Administrative access

Some access isn't part of the grid. The **Roles** tab lists it under **Administrative access**,
and it can't be changed for any role.

<RoleGrants show="admin" />

## How roles behave

**One role per member.** You choose a member's role when you invite them, and can change it on
the [Users](/user-guide/settings/identity-and-access/users) tab. A change takes effect right
away.

**Teams add, never take away.** A member of a team with a team role gets that role's
permissions as well as their own. See [Teams](/user-guide/settings/identity-and-access/teams).

**Workspaces come first.** A role applies in the workspaces a member can use. Owners and Admins
get every workspace, and everyone else uses the workspaces they have been given. See
[Organizations and workspaces](/user-guide/get-started/organizations-and-workspaces#key-concepts).

**The Owner is one person.** Every organization has exactly one owner, and only the owner can
transfer ownership. Nobody else can be given the **Owner** role.

**Tools act with your role.** The Productmind CLI, AI assistants and API clients you sign in to
can do exactly what your role allows, and nothing more. See
[API access and authentication](/user-guide/tools/api-access). Changing application and sandbox
settings through an AI assistant is for the **Owner** and **Admin** roles only, whatever else a
role allows. See [AI assistants](/user-guide/tools/ai-assistants#application-and-sandbox-settings).

**Roles are managed by Productmind.** You can't edit a role in the app. To get a role that fits
a job the built-in roles don't, contact Productmind support.

## Troubleshooting

### A menu item or a button is missing

Find the page's permission in the tables above, then check your role: choose your avatar at the
bottom of the sidebar, then **Profile**. Under **Your organizations**, your role is shown next to
each organization. Or ask an Owner or Admin of your organization. If your role should allow it, the feature may be
behind a rollout: see the page's **Availability** block, and
[Troubleshooting](/user-guide/reference/troubleshooting). A feature your plan doesn't include
isn't missing: it shows a lock. See
[Features that depend on your plan](/user-guide/reference/plans-and-limits#features-that-depend-on-your-plan).

## Related topics

- [Roles](/user-guide/settings/identity-and-access/roles)
- [Users](/user-guide/settings/identity-and-access/users)
- [Teams](/user-guide/settings/identity-and-access/teams)
- [Plans and limits](/user-guide/reference/plans-and-limits)
