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

# Groups and permissions

> Create Enterprise groups, add collaborators, and configure Workspace, group, and app permissions so each team has the access it needs to work in Replit.

Groups let you manage permissions for several collaborators at once. Create groups for teams such as Finance, Marketing, or Design, then grant each group the access it needs.

Custom groups are available on Enterprise. They add access alongside a collaborator's base role; they don't replace that role.

## Create a group and add members

<Steps>
  <Step title="Open Groups">
    Select your team Workspace and open **Settings** using the cogwheel in the bottom-left corner. Under **Workspace**, select **Groups**.

    This page separates built-in **Roles** from your custom **Groups**.

    <Frame caption="The Groups page with example departments. Account details are examples.">
      <img src="https://mintcdn.com/replit/4GRNrFZsQB2Pgalf/images/workspace/groups-departments.jpg?fit=max&auto=format&n=4GRNrFZsQB2Pgalf&q=85&s=24f915b8274ba797c22c3ec7dda9c77b" alt="Groups settings showing built-in roles and custom groups named Sales, Finance, Marketing, Operations, Engineering, and People, with an Add button in the top-right corner." width="1536" height="891" data-path="images/workspace/groups-departments.jpg" />
    </Frame>
  </Step>

  <Step title="Create your group">
    Select **+ Add** in the top-right corner. Enter a group name; you can also choose a color and icon to make it easier to recognize. Complete the creation dialog to open your new group.

    To manage an existing group, select its card on the Groups page.
  </Step>

  <Step title="Open the group's members">
    Inside the group, select **Members** to see who belongs to it. Select **+ Add** to add collaborators.

    <Frame caption="Group Members with names replaced and emails and usernames hidden.">
      <img src="https://mintcdn.com/replit/4GRNrFZsQB2Pgalf/images/workspace/groups-members.jpg?fit=max&auto=format&n=4GRNrFZsQB2Pgalf&q=85&s=2bf0fdddaa010d805b8d9ff6a3b2ec30" alt="Group Members page with a sanitized member list and an Add button." width="1536" height="891" data-path="images/workspace/groups-members.jpg" />
    </Frame>
  </Step>

  <Step title="Add collaborators to the group">
    Search for Workspace members by username or email and select the people to add. You can also paste a comma-separated list to add several people at once. Select **Add to group**.

    <Frame>
      <img src="https://mintcdn.com/replit/4GRNrFZsQB2Pgalf/images/workspace/groups-add-members.jpg?fit=max&auto=format&n=4GRNrFZsQB2Pgalf&q=85&s=ff250dfb82ba4d9322144d114ce4b8ff" alt="Add members to Designers dialog with a username or email search field, comma-separated list instructions, and an Add to group button." width="1247" height="568" data-path="images/workspace/groups-add-members.jpg" />
    </Frame>
  </Step>
</Steps>

## Configure group permissions

Inside the group, select **Permissions** in the left navigation. The three tabs control different resources: **Workspace**, **Groups**, and **Apps**.

Choose the lowest access level that lets the group do its work. Review permissions before adding more members, because grants to the group apply to its members.

### Workspace permissions

On the **Workspace** tab, choose the group's **Organization access** level, then select **Save changes**.

<Frame>
  <img src="https://mintcdn.com/replit/4GRNrFZsQB2Pgalf/images/workspace/groups-workspace-permissions.jpg?fit=max&auto=format&n=4GRNrFZsQB2Pgalf&q=85&s=83e1d04a517eb238a82cdbb64e495700" alt="Group Permissions Workspace tab with Organization access choices and a Save changes button." width="1536" height="891" data-path="images/workspace/groups-workspace-permissions.jpg" />
</Frame>

| Level           | What it allows                                                                              |
| --------------- | ------------------------------------------------------------------------------------------- |
| Owner           | All organization actions, including deleting the organization.                              |
| Billing manager | Update payment information, add or remove seats, and set spending limits.                   |
| Manager         | Create and manage groups, add or remove organization members, and view billing information. |
| Editor          | Create apps and view usage information.                                                     |
| Viewer          | View basic organization information.                                                        |

These are permissions granted through a group, not the Member, Guest, or Viewer roles you choose when inviting a collaborator.

### Access to other groups

On the **Groups** tab, use the **Role** dropdown beside a role or custom group to set the current group's access to that target group. For example, you can let members of the Designers group view another group's membership without allowing them to change it.

<Frame>
  <img src="https://mintcdn.com/replit/4GRNrFZsQB2Pgalf/images/workspace/groups-group-permissions.jpg?fit=max&auto=format&n=4GRNrFZsQB2Pgalf&q=85&s=f5326a996aa2e679ebff9a19027a7437" alt="Groups permissions tab listing built-in roles and custom groups with per-row Role dropdowns." width="1536" height="891" data-path="images/workspace/groups-group-permissions.jpg" />
</Frame>

| Level      | What it allows on the target group                                    |
| ---------- | --------------------------------------------------------------------- |
| Owner      | View and manage members, edit the group's name, and delete the group. |
| Manager    | View and manage members, but not edit or delete the group.            |
| Viewer     | View the group and its members.                                       |
| Restricted | View and leave the group, but not see other members.                  |
| None       | No access to the group through this grant.                            |

The available options depend on the target group and your permissions. **All**, **Viewer**, and **None** above the lists are filters, not controls that grant access to every group.

### App permissions

On the **Apps** tab, use each app's **Role** dropdown to choose the group's access to that app.

<Frame caption="App names have been replaced with examples.">
  <img src="https://mintcdn.com/replit/4GRNrFZsQB2Pgalf/images/workspace/groups-app-permissions.jpg?fit=max&auto=format&n=4GRNrFZsQB2Pgalf&q=85&s=722c3a400a88687aa056193a6434678a" alt="Apps permissions tab with example projects and an open dropdown showing Owner, Publisher, Editor, Read-only, and None." width="1536" height="891" data-path="images/workspace/groups-app-permissions.jpg" />
</Frame>

| Level     | What it allows on the app                      |
| --------- | ---------------------------------------------- |
| Owner     | Full permissions, including deleting the app.  |
| Publisher | Edit and publish the app.                      |
| Editor    | Edit the app.                                  |
| Read-only | View the published app without editing it.     |
| None      | No permissions through this group's app grant. |

<Note>
  Removing a group's access doesn't remove access a person has through their base role or another grant. Review those permissions too when restricting access.
</Note>

For more detail, see [Roles, Groups and Access](/teams/identity-and-access-management/groups-and-permissions). If you sync groups from your identity provider, see [SCIM provisioning](/teams/identity-and-access-management/scim).

## Next step

<Card title="Privacy and deployment settings" icon="shield-halved" href="/teams/privacy-and-deployment-settings">
  Control how your team publishes apps and protects access.
</Card>
