---
title: Default roles
url: /docs/administration/concepts/rbac/default-roles/
---


Every Pulumi Cloud organization has a default role. Members follow it unless an admin assigns them another role, and so do new members who accept an invite that doesn't name a role. When an admin changes the default role, every member who follows it moves to the new role at once, and members with an assigned role keep theirs.

## Built-in roles

Three built-in roles are designed to be the default role. Each one includes everything the role before it allows.

| Role | What members can do |
|------|---------------------|
| `Reader` | Read the organization's stacks, environments, and cloud accounts. Members still manage what they own, such as resources they created under a previous role. |
| `Builder` | Everything Reader allows, plus create stacks, environments, cloud accounts, services, and Pulumi Neo tasks. Members manage what they create. |
| `Maintainer` | Everything Builder allows, plus change every stack, environment, cloud account, and service, and work with deployments, integrations, and Neo automations. |

Managing members, teams, and organization settings stays with the `Admin` role. To give someone permissions on specific stacks, environments, or cloud accounts beyond what their role allows, [grant them a permission set on those entities](/docs/administration/concepts/rbac/entities/#entity-access) or add them to a [team](/docs/administration/concepts/rbac/teams) that has those permissions.

## Choosing a default role

New organizations come with a default role already set, and admins can change it.

In editions with [custom roles](/docs/administration/concepts/rbac/roles/#custom-roles) (Pro, Enterprise), admins choose the default role and can assign individual members a different role. For most of these organizations, we recommend `Builder`: members create and manage their own infrastructure, and get permissions on everyone else's through [teams](/docs/administration/concepts/rbac/teams) or [grants on individual entities](/docs/administration/concepts/rbac/entities/#entity-access), so permissions on shared resources are something you grant on purpose. Choose `Reader` if most members only need to look, and `Maintainer` if every member should be able to change everything. A custom role can also be the default.

In other editions, the default role is `Maintainer`, and members follow it or are admins or billing managers.

## Changing the default role

You must be an organization admin, in an edition with custom roles, to change the default role, except to move off `Member (legacy)`, which any edition can do.

1. Navigate to **Settings** > **Access management** and select the **Roles** tab.
1. In **Default organization role**, choose the role you want as the default.
1. Confirm the change.

You can also open a role and choose **Actions** > **Set as default organization role**.

## Moving from the Member role {#moving-from-member}

> **Note:** Pulumi Cloud organizations moved from the `Member` role to Reader, Builder, and Maintainer in November 2026.

Organizations used to give members a configurable `Member` role. They moved to Reader, Builder, and Maintainer without losing any permissions. Each one got the three roles, and its default role became the built-in role matching what members could already do. Where none matched, the default role became `Member (legacy)`, a copy of those permissions, and an organization that already had a custom default role kept it. Custom roles, teams, and access tokens kept their permissions, and a custom role that was already named `Reader`, `Builder`, or `Maintainer` was renamed, for example to `Builder (custom)`.

### Member (legacy) {#member-legacy}

You can't edit `Member (legacy)`. To move your organization to a built-in role, which any edition can do:

1. Open `Member (legacy)` and compare it with the built-in role you want, usually `Builder`. Note what members can do today that the built-in role doesn't cover, such as changing stacks or environments that other people created.
1. Give those permissions to the members who need them before you switch, for example through [teams](/docs/administration/concepts/rbac/teams) that own those stacks and environments.
1. [Change the default role](#changing-the-default-role) to the built-in role.
1. Sign in as a member, or ask one, to check that day-to-day work still succeeds.

If something stops working, switch the default role back to `Member (legacy)` while you sort out the missing permissions.

