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

# Let members view permission-group membership

> Grant one permission group Read access to another so members can inspect membership without receiving that group's project permissions.

> [!NOTE]
>
> **Applies to:**
>
> * Plan - Enterprise
> * Deployment - SaaS, BYOC
> *
> * Use case - Let members identify their permission groups and find project-group owners without granting additional project permissions

## Summary

Grant one permission group **Read** access to another so its members can inspect the **Members** tab. This lets them identify who to contact without receiving the permissions that the other group grants.

## What is happening

Access to a permission group is separate from membership in that group. Granting **Read** access lets someone view its membership. It does not add them to the group or grant its project-creation or administrative permissions.

For example, your organization might have custom permission groups named **Project A Owners**, **Project A Engineers**, and **Project A Viewers**. Assume **Project A Owners** can create projects in the relevant project group, while **Project A Engineers** cannot. You can let Engineers identify an Owner to contact without granting Engineers project-creation permissions.

> [!NOTE]
>
> These are custom groups with permissions configured by your organization. The
> built-in **Engineers** group already grants project creation across the
> organization. See [Built-in permission
> groups](https://docs.braintrust.dev/admin/access-control.md#built-in-permission-groups).

## Fix or suggestion

### Grant access to the relevant permission groups

Members of the [**Owners**](https://docs.braintrust.dev/admin/access-control.md#built-in-permission-groups) permission group can configure this access by default. To let another member configure it, grant the **Manage access** permission on the relevant permission group in ** Settings** > [** Permissions**](https://www.braintrust.dev/app/~/configuration/permissions/organization).

1. Go to ** Settings** > [** Permissions**](https://www.braintrust.dev/app/~/configuration/permissions/organization).
2. Under **Permission groups**, hover over **Project A Owners**, then click the manage access icon ().
3. Select the **Permission groups** tab.
4. Search for **Project A Engineers**, then click the edit icon () next to it.
5. Select **Read**, then click **Save**.
6. Repeat for **Project A Engineers** and **Project A Viewers** if the team also needs to inspect membership of those groups.

### View membership

As a member of **Project A Engineers**:

1. Go to ** Settings** > [** Permissions**](https://www.braintrust.dev/app/~/configuration/permissions/organization).
2. Click **Project A Owners**, then select the **Members** tab.
3. Find a member to contact about creating a project.
4. Open the other groups you have **Read** access to and check their **Members** tabs to find your own membership.

## How to confirm it worked

* Confirm a member of **Project A Engineers** can open the relevant groups and inspect their **Members** tabs.
* Confirm the member's existing project-creation permissions are unchanged. For this example, a member who previously lacked project-creation permissions should still be unable to create a project.

Effective permissions combine direct grants and permissions inherited through groups. If the member can create projects, review all sources of their access.

## Related membership setup

To grant project access, [add the member to a permission group](https://docs.braintrust.dev/admin/access-control/manage-permissions.md#manage-group-membership) that provides **Read** access to the intended projects. Direct permissions can also provide project access.

SSO authentication does not by itself synchronize permission-group membership. [Domain mappings](https://docs.braintrust.dev/admin/authentication.md#domain-mappings) can assign a permission group when someone first joins an organization.

To automate ongoing membership changes, see [SCIM provisioning](https://docs.braintrust.dev/admin/scim.md). When permission-group synchronization is enabled, members need membership in both the organization's mapped IdP group and the IdP group mapped to the relevant Braintrust permission group. Change SCIM-managed membership in your identity provider.

> [!NOTE]
>
> SCIM provisioning requires an Enterprise plan and private-preview access. It
> is available to a limited set of customers, and behavior can change during the
> preview. [Contact Braintrust](https://www.braintrust.dev/contact) to request
> access.

## Notes

For more details, see [Manage access to a permission group](https://docs.braintrust.dev/admin/access-control/manage-permissions.md#manage-access-to-a-permission-group) and [Manage group membership](https://docs.braintrust.dev/admin/access-control/manage-permissions.md#manage-group-membership).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.