Groups & Teams

A group is a named list of users used purely for access control. Add a group as a collaborator on a repo or an entire workspace to grant all its members access at once. Groups do not own repos or workspaces directly.

Creating a group

Groups are created within a workspace. Go to your workspace page, open the Groups tab, and click Create a new group. Choose a name (2–32 chars, lowercase, letters/digits/hyphens) and an optional description. The creator is automatically the first member.

Adding members to a group

From the group's Members tab, click + Add member. Type to search for users by name or username. Only active users appear; users already in the group are excluded from suggestions.

There is no "owner" role within a group — all members are equal. Adding and removing members requires workspace admin access.

Removing members

From the group's Members tab, click Remove next to any member. A group must always have at least one member — the last member cannot be removed.

Using a group as a repo collaborator

A group can be added as a collaborator on any repo. Open the repo's Settings tab, click + Add collaborator, search for the group, and assign a role (read or read & write).

Every current and future member of the group will have the assigned role on that repo. When someone joins the group, they gain access automatically; when they leave, it's revoked.

Using a group for workspace-wide access

A group can also be granted access to an entire workspace, covering all its repos at once. From the workspace Members tab, click + Add member, pick the group, and choose a role.

Workspace-level access is ideal for a core team that needs access to everything. For contractors or guests who should only see specific repos, use a repo-level collaborator grant instead.