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

# Access groups

> Learn how to manage who can view and edit a project in Openlayer using role-based access control (RBAC).

Access groups let you control **who can access a project** and what they can do inside it.
They are Openlayer's way of providing **role-based access control (RBAC) at the project level**.

<Info>
  Access groups manage **project-level** permissions. For an overview of
  **workspace-level** roles and their permissions, see [Roles and
  permissions](/security/roles-and-permissions).
</Info>

By creating access groups, you can:

* Limit access to sensitive projects.
* Assign roles like **Admin**, **Member**, or **Viewer**.
* Ensure only the right people can view or edit traces, tests, and results.

## How it works

* Access groups are defined **per project**.
* Each group has:
  * A **name** (to identify the group).
  * A **role** (Admin, Member, or Viewer).
  * A list of **members** (users in your organization).

Roles determine what permissions group members get:

| Role   | Permissions                                                                 |
| ------ | --------------------------------------------------------------------------- |
| Admin  | Full control: manage access groups, edit project settings, create/edit data |
| Member | View and edit project data (but not manage access groups)                   |
| Viewer | Read-only access to project data and results                                |

## Create an access group

You can create and manage groups directly from the **project settings**.

<Steps>
  <Step title="Open project settings">
    In your Project settings, select the project you want to manage access
    groups for and click on **Access groups**.

    <img width="700" style={{ borderRadius: "0.5rem" }} src="https://mintcdn.com/openlayer-44/bGUzk0zySXHh8oF5/images/documentation/access_groups_sidebar.png?fit=max&auto=format&n=bGUzk0zySXHh8oF5&q=85&s=bec447d1a1f0e38322d95be737923f75" alt="Access groups in project sidebar" data-path="images/documentation/access_groups_sidebar.png" />
  </Step>

  <Step title="Create a new group">
    Click **Create access group**.

    <img width="700" style={{ borderRadius: "0.5rem" }} src="https://mintcdn.com/openlayer-44/bGUzk0zySXHh8oF5/images/documentation/access_groups_empty.png?fit=max&auto=format&n=bGUzk0zySXHh8oF5&q=85&s=aa5f33f2ac95dd2b38a9673bc3e039ea" alt="Create new access group" data-path="images/documentation/access_groups_empty.png" />
  </Step>

  <Step title="Set role and members">
    * Give the group a name. - Select a project role (Admin, Member, Viewer). -
      Add members from your organization to the group.
  </Step>
</Steps>

## Editing and removing groups

* To edit a group, select it from the list, then update its role or membership.
* To remove a group, click the delete icon next to it.

## Hide projects that have no access group

By default a project with no access groups is visible to everyone in the workspace, and access groups
only ever narrow that. If you would rather start from the opposite default, turn on **Hide projects
without access group** under **Workspace settings** → **Security** → **Access control**.

With it on, a non-admin sees only the projects they have been explicitly added to through an access
group. A project with no access groups becomes invisible to them. Admins continue to see every
project.

Turn it on before you create your access groups. Doing it the other way round hides every project
from non-admins until you have added them to one.

## Best practices

* **Use Admin groups sparingly**: reserve for team leads or project owners.
* **Create Member groups per function** (e.g., “Evaluation team”, “Data science team”).
* **Add external collaborators as Viewers** to safely share results.

## FAQ

<AccordionGroup>
  <Accordion title="Can a user belong to multiple groups in a project?">
    Yes. If a user belongs to multiple groups, the most permissive role applies.
    For example, if they are both a Viewer and a Member, they will have Member
    permissions.
  </Accordion>

  <Accordion title="Are access groups global or per project?">
    Access groups are **per project**. You can define different groups for each
    project.
  </Accordion>

  <Accordion title="Do I need to create access groups for every project?">
    No. By default, all workspace members have access. Access groups are only
    needed when you want to **restrict access**.
  </Accordion>
</AccordionGroup>
