Teams
Teams help you organize members and control access to repositories. Members assigned to a team can access all repositories associated with that team.
Team Concepts
Team Membership
Members can belong to multiple teams. All team members have equal access to team resources.
Team Repository Access
When a repository is assigned to a team:
- All team members can access the repository
- Access is granted based on their organization role
Creating a Team
- Go to Teams
- Click New Team
- Enter a Team Name (e.g., "Engineering")
- Optionally add a Description
- Click Create Team
Managing Teams
Viewing Team Details
- Go to Teams
- Click View Team on a team
- View members and repositories
Editing a Team
- View the team details
- Click Edit
- Update the name or description
- Click Save Changes
Deleting a Team
- View the team details
- Click Delete Team
- Confirm the deletion
Deleting a team:
- Removes all team associations
- Does not delete members or repositories
- Members lose team-based repository access
Team Members
Adding Members
- View the team details
- Under Members, click Add Member
- Select members from the organization
- Click Add Members
Members can be added individually or in bulk by selecting multiple users.
Removing Members
- View the team details
- Find the member in the list
- Click Remove
Pending Invitations
The team detail view shows:
- Members tab - Current team members
- Pending tab - Invited users assigned to this team
Pending invitations can be:
- Resent - Send the invitation email again
- Cancelled - Remove the invitation
Team Repositories
Adding Repositories
- View the team details
- Under Repositories, click Add Repository
- Select repositories from the organization
- Click Add Repositories
Removing Repositories
- View the team details
- Find the repository in the list
- Click Remove
Use Cases
Department Teams
Organize by department:
- Engineering - Technical documentation
- Sales - Sales materials and guides
- HR - Employee handbook and policies
Project Teams
Organize by project:
- Project Alpha - Project Alpha documentation
- Project Beta - Project Beta documentation
Client Teams
For agencies or consultants:
- Client A - Client A documentation
- Client B - Client B documentation
Permissions
Team management requires specific permissions:
| Action | Required Role |
| View teams | Admin (Members can only view teams they belong to) |
| Create teams | Admin |
| Edit teams | Admin |
| Delete teams | Admin |
| Add members | Admin |
| Remove members | Admin |
| Add repositories | Admin |
| Remove repositories | Admin |
Team-Based Access for Members
Members can only view repositories and teams they are assigned to via team membership. This allows fine-grained control over what each Member can access:
- Add Members to specific teams to grant access to those team's repositories
- Remove Members from teams to revoke access
- Members cannot see repositories or teams they are not assigned to