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

# Assign Group Access

> Assign a group to a project or account with a role to grant its members access.

A group grants access when you assign it to a project or an account and give the assignment a role. Every member of the group inherits that role on the resource, and the grant tracks the group's membership as people join or leave. [Synced groups](/secure/identity-and-access/provisioning/scim/groups) from your identity provider are assigned the same way.

The role lives on the assignment, not the group, so the same group can be an **Admin** on one project and a **Viewer** on another. Assign a group to a project first. Assigning it to a specific account is optional, and only possible once the group is on that account's parent project.

## Prerequisites

* A group in your organization. Create and populate one on the **Groups** tab of **Organization > Manage Team**, covered in [Manage Groups](/secure/identity-and-access/groups/manage-groups).
* Organization **Admin**, or **Admin** on the project, to assign a group to a project.
* Account **Admin** on the account to assign a group to it. Organization and project admins have this by default, so they can assign account groups without an extra grant. If your organization uses **explicit account access**, org and project admins instead need an explicit account **Admin** grant on the account (see [How access resolves](#how-access-resolves)).

## Assign a group to a project

<Steps>
  <Step title="Open the project's group access">
    Go to **Project Settings > Access** and switch the view from **Members** to **Groups**. The **Groups** view lists every group that already grants access to this project.

    <Frame>
      <img src="https://mintcdn.com/stackone-60/z6bSbDsMY4CzvXKv/images/secure/identity-and-access/groups/project-access-groups.png?fit=max&auto=format&n=z6bSbDsMY4CzvXKv&q=85&s=140a33f630b2e544d8236e38724e69d7" alt="Project Settings > Access with the Members / Groups switch set to Groups, showing each assigned group with its role and a Revoke action." data-og-width="1568" width="1568" data-og-height="220" height="220" data-path="images/secure/identity-and-access/groups/project-access-groups.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/stackone-60/z6bSbDsMY4CzvXKv/images/secure/identity-and-access/groups/project-access-groups.png?w=280&fit=max&auto=format&n=z6bSbDsMY4CzvXKv&q=85&s=aaa41b6b8c385e3d66d9fb4ee1c86e8f 280w, https://mintcdn.com/stackone-60/z6bSbDsMY4CzvXKv/images/secure/identity-and-access/groups/project-access-groups.png?w=560&fit=max&auto=format&n=z6bSbDsMY4CzvXKv&q=85&s=31fad2badaebfc418f5fd64b28af6704 560w, https://mintcdn.com/stackone-60/z6bSbDsMY4CzvXKv/images/secure/identity-and-access/groups/project-access-groups.png?w=840&fit=max&auto=format&n=z6bSbDsMY4CzvXKv&q=85&s=e3d1ae39ae9b3374f5128528e2daee17 840w, https://mintcdn.com/stackone-60/z6bSbDsMY4CzvXKv/images/secure/identity-and-access/groups/project-access-groups.png?w=1100&fit=max&auto=format&n=z6bSbDsMY4CzvXKv&q=85&s=63d14971989eb055e39fa6a1e587acb6 1100w, https://mintcdn.com/stackone-60/z6bSbDsMY4CzvXKv/images/secure/identity-and-access/groups/project-access-groups.png?w=1650&fit=max&auto=format&n=z6bSbDsMY4CzvXKv&q=85&s=8d5a827ac0935de671b6189e43e659d3 1650w, https://mintcdn.com/stackone-60/z6bSbDsMY4CzvXKv/images/secure/identity-and-access/groups/project-access-groups.png?w=2500&fit=max&auto=format&n=z6bSbDsMY4CzvXKv&q=85&s=62887719dbbb2181315616c20b345a7f 2500w" />
    </Frame>
  </Step>

  <Step title="Select groups and a role">
    Click **Add Groups**, select one or more groups, then choose a **Role**. The picker offers only groups not already on the project.

    | Role       | Grants                                                        |
    | ---------- | ------------------------------------------------------------- |
    | **Admin**  | Full control of the project, its connections and its members. |
    | **Member** | Can use the project and manage their own connected accounts.  |
    | **Viewer** | Read-only access to the project.                              |

    The role defaults to **Member**.

    <Frame>
      <img src="https://mintcdn.com/stackone-60/z6bSbDsMY4CzvXKv/images/secure/identity-and-access/groups/assign-project.png?fit=max&auto=format&n=z6bSbDsMY4CzvXKv&q=85&s=5f7b62c11ca174085059a22fb78a5432" alt="The Add Groups side panel on a project's Access view, with a Groups selector and a Role dropdown set to Project Member." style={{ maxWidth: "360px" }} width="896" height="1350" data-path="images/secure/identity-and-access/groups/assign-project.png" />
    </Frame>
  </Step>

  <Step title="Add the groups">
    Click **Add groups** to confirm. Every member of each selected group gains the chosen role on the project.
  </Step>
</Steps>

## Assign a group to an account

Account access is a subset of project access, so you can assign a group to an account only after it is assigned to that account's parent project. If a group is missing from the account picker, assign it to the project first.

<Steps>
  <Step title="Open the account's group access">
    Open the account and go to its **Access** tab, then switch to **Groups**. The **Groups** view lists every group assigned directly to this account.

    <Note>
      This view lists only groups assigned **directly** to the account. Groups assigned to the parent project also grant access here, see [How access resolves](#how-access-resolves), but they're shown and managed on the project's **Access** view, not here.
    </Note>
  </Step>

  <Step title="Select groups and a role">
    Click **Add Groups**, select one or more groups, then choose a **Role**. The picker offers only groups already assigned to the account's parent project.

    | Role       | Grants                                                     |
    | ---------- | ---------------------------------------------------------- |
    | **Admin**  | Full control of the account, its settings and its members. |
    | **Member** | Can use the account and execute actions.                   |

    The role defaults to **Member**.
  </Step>

  <Step title="Add the groups">
    Click **Add groups** to confirm. Every member of each selected group gains the chosen role on the account.
  </Step>
</Steps>

## How access resolves

A user's effective role on a resource is the **strongest** role they hold there. A group grant can only raise a user's access, never lower it: a project **Viewer** who also belongs to a group assigned as **Admin** on the project has **Admin** there, while a group assigned a weaker role than someone's direct membership leaves that person unchanged. This lets you add a group broadly without demoting anyone.

<Frame>
  <img src="https://mintcdn.com/stackone-60/z6bSbDsMY4CzvXKv/images/secure/identity-and-access/groups/project-access-members.png?fit=max&auto=format&n=z6bSbDsMY4CzvXKv&q=85&s=0e6fbef041046fce36cff2a93be033ac" alt="Project Settings > Access, Members view, with Role and Effective role columns, the Effective role flags anyone whose role a group has raised." data-og-width="1568" width="1568" data-og-height="281" height="281" data-path="images/secure/identity-and-access/groups/project-access-members.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/stackone-60/z6bSbDsMY4CzvXKv/images/secure/identity-and-access/groups/project-access-members.png?w=280&fit=max&auto=format&n=z6bSbDsMY4CzvXKv&q=85&s=581c8d732330ad434b321ef646cab17c 280w, https://mintcdn.com/stackone-60/z6bSbDsMY4CzvXKv/images/secure/identity-and-access/groups/project-access-members.png?w=560&fit=max&auto=format&n=z6bSbDsMY4CzvXKv&q=85&s=370c74cfc7970082f11814b4759572c6 560w, https://mintcdn.com/stackone-60/z6bSbDsMY4CzvXKv/images/secure/identity-and-access/groups/project-access-members.png?w=840&fit=max&auto=format&n=z6bSbDsMY4CzvXKv&q=85&s=3e33c6d670338b3424594f36a4dbd466 840w, https://mintcdn.com/stackone-60/z6bSbDsMY4CzvXKv/images/secure/identity-and-access/groups/project-access-members.png?w=1100&fit=max&auto=format&n=z6bSbDsMY4CzvXKv&q=85&s=b5976cdb687727bc8f096b4bf2b4d2b2 1100w, https://mintcdn.com/stackone-60/z6bSbDsMY4CzvXKv/images/secure/identity-and-access/groups/project-access-members.png?w=1650&fit=max&auto=format&n=z6bSbDsMY4CzvXKv&q=85&s=093c8453cf93a046bfb448c181196fc3 1650w, https://mintcdn.com/stackone-60/z6bSbDsMY4CzvXKv/images/secure/identity-and-access/groups/project-access-members.png?w=2500&fit=max&auto=format&n=z6bSbDsMY4CzvXKv&q=85&s=8f27743d64904f063946a10686d275a0 2500w" />
</Frame>

On a **project**, the effective role is the strongest of a user's direct project membership and every group they belong to that is assigned to the project.

On an **account**, the effective role is the strongest of those same two sources **and** the access inherited from the account's parent project. This inheritance is easy to miss in an access review: an account with no direct members is rarely as restricted as its **Members** list suggests.

| Their standing                                          | Inherited account access                                                            |
| ------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| Organization Admin                                      | **Admin** on every account in the organization                                      |
| **Admin** on the project (directly or through a group)  | **Admin** on every account under that project                                       |
| **Viewer** on the project (directly or through a group) | View every linked account under that project                                        |
| **Member** on the project                               | None. They see only the accounts they linked and any they've been granted access to |

A direct account grant or an account-level group can raise this, never lower it.

<Info>
  If your organization uses **explicit account access**, organization and project admins get read-only account access by default instead of **Admin**. Executing actions then needs an explicit account **Member** grant, and reconnecting, editing, deleting, or managing access needs an explicit account **Admin** grant. Everything else on this page works the same.
</Info>

<Note>
  Only active organization members inherit a group's role. A user who is banned or removed from the organization stops inheriting group access until they are restored, even though the group assignment stays in place.
</Note>

## Change or remove a group's access

To change a group's role, open the **Groups** view on the project or account and pick a new role on the group's row. To revoke the access, click **Revoke** on the group's row and confirm.

<Warning>
  Removing a group from a project also removes it from every account under that project, because account access is a subset of project access. Removing a group from a single account leaves its project assignment intact.
</Warning>

<Note>
  If a group is the only thing granting you access to a project, you can't revoke it yourself, StackOne blocks the removal so you don't lock yourself out. Ask an organization admin to make the change.
</Note>

## Next steps

<CardGroup cols={2}>
  <Card title="Groups Overview" icon="users" href="/secure/identity-and-access/groups/overview">
    What groups are and how they grant access.
  </Card>

  <Card title="Manage Groups" icon="user-gear" href="/secure/identity-and-access/groups/manage-groups">
    Create groups and manage who belongs to them.
  </Card>
</CardGroup>
