> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/guides-and-quickstarts/organization-administration/groups-and-membership.md).

# Groups and membership

Groups let you manage access for a team instead of selecting each person separately. Add members to a group, then use the group in sharing settings.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2FKVCjiGHCucJV5yHKp1k3%2FG089.mp4?alt=media&token=08554b59-8b8e-406c-b5c3-58aa35416ec1>" %}

## Before you start

Use a group when the same people should receive the same shared access. Confirm its membership owner and whether it is locally managed or synchronized from your identity provider. Invite missing people using [Members and invitations](https://docs.stackai.com/guides-and-quickstarts/organization-administration/members-and-invitations.md) before selecting them for a local group.

You need permission to manage groups and access to the folder you want to share.

## Create a group

Open Settings → Groups and review names, descriptions, and member counts.

![Groups list and membership counts](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/zfMHlk6jJlVlEwxKrLF3/assets/g089-g089-01-list.png)

Check whether an existing group already represents the team you need.

Select Add Group and enter a clear name and description.

![Add Group name and description](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/jiXdenkzra1ffqH9j5ri/assets/g089-g089-02-create.png)

Describe the team or access purpose so administrators can maintain the group consistently.

## Add members

Open the group's Members control and review its membership.

![Group Members control](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/LlRjkp6tI5IZTJQf3tUR/assets/g089-g089-03-members.png)

Select Add Members to include the people who belong in the group.

Search for and select the intended members.

![Group member selection](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/LdcFSLzb0aqPsmKbb9bz/assets/g089-g089-04-add.png)

Confirm the saved member list and count after making the change.

## Give the group folder access

Open the target folder's settings and review its sharing controls.

![Folder group-sharing controls](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/lNHvqpOEWJnYSuziScBy/assets/g089-g089-05-share.png)

Select the group only when all of its members should receive that folder access.

## Delete an unused group

Review a group's use before deleting it.

![Group deletion confirmation](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/xhUJWKToyo4yurcf8bfH/assets/g089-g089-06-cleanup.png)

Read the confirmation and preserve groups that still support required team access.

## Remove one member without deleting the group

For a locally managed group, open its **Members** control, open the membership selection form, clear the departing person's selection, and save the membership update. Reopen Members and confirm the person is no longer listed. Preserve the group itself when other people still need its shared resources.

Removing one group membership removes that route to group-shared access. It does not remove the person from the organization, and other group memberships or direct grants can still provide access. Review the target folder or project with the affected account through your approved access-check process. For full offboarding, follow [Members and invitations](https://docs.stackai.com/guides-and-quickstarts/organization-administration/members-and-invitations.md).

For a group synchronized through SCIM or SSO, make the membership change in the identity provider with IT, then verify the synchronized result in StackAI. A local change is not a durable replacement for the directory's membership assignment. For SCIM, group synchronization must be enabled; follow [SCIM provisioning](https://docs.stackai.com/guides-and-quickstarts/organization-administration/scim-provisioning.md) if the expected change does not arrive.

## Important behavior

Folder access granted to a group applies to its members. Review the group’s use before removing it.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/guides-and-quickstarts/organization-administration/groups-and-membership.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
