Teams & Collaboration
Teams enable collaboration by allowing multiple people to work together on projects. This guide covers creating teams, managing members, and understanding permissions.
What Are Teams?
Teams are:
- Collaboration Groups - Organize people working together
- Permission Managers - Control access to projects and resources
- Project Organizers - Share projects among team members
- Access Controllers - Manage who can do what
Teams help you collaborate effectively by grouping people together and managing their access to projects and features.
Creating a Team
Open Create Team Modal
From the dashboard, find the Teams section and click Create Team:
- Click the button in the Teams section
- Or use the navigation if available
A modal will open asking for team details.
Enter Team Name
In the create team modal:
- Team Name - Enter a descriptive name (e.g., "Frontend Team", "Product Team")
- Requirements:
- Must be 1-30 characters
- Use clear, descriptive names
- Consider your organization's naming conventions
Use team names that reflect their purpose or department. Examples: "Engineering", "QA Team", "Product Managers".
Create the Team
Click Create to create your team. You'll be the team owner and can start adding members immediately.
Once created, you can add members and assign them to projects. The team will appear in your Teams section.
Managing Teams
Viewing Teams
The Teams section on the dashboard shows:
- Team Cards - All teams you're a member of
- Team Name - Displayed as "name" Team
- External Tag - Teams created by others where you have limited permissions
- Actions - Manage or delete options
Team Actions
For each team, you can:
- Manage - Access team settings and members
- Delete - Remove the team (only if you're the owner)
Deleting a team is permanent and will remove all member associations. Make sure you want to delete the team before confirming.
Team Members
Adding Members
Open Team Management
Click Manage on a team card to open the team management modal.
Invite Members
In the team management modal:
- Navigate to the Members tab
- Click Invite Member or use the invite form
- Enter the member's email address
- Send the invitation
Members will receive an invitation email. They need to accept the invitation to join the team.
Member Roles
When adding members, you can assign roles:
- Admin - Full control over the team
- Developer - Can manage flags and settings
- Tester - Can test flags
- Viewer - Can view flags
Start with Developer role. You can always change roles later.
Managing Members
In the team management modal, you can:
- View Members - See all team members and their roles
- Remove Members - Remove members from the team
- Change Roles - Update member permissions
Project Members
Teams work alongside project-level member management. You can:
Add Members to Projects
- Go to Settings → Members in your project
- Click Add Member
- Select from team members
- Assign project role
Project Roles
Project roles determine what members can do:
- Developer - Can manage flags and settings
- Tester - Can test flags and other basic features
- Viewer - Can view flags
Project roles are separate from team roles. A team member might have different permissions in different projects.
Permissions Overview
Team Permissions
Team-level permissions control:
- Who can manage the team
- Who can add/remove members
- Who can delete the team
Project Permissions
Project-level permissions control:
- Who can create/edit/delete flags
- Who can modify project settings
- Who can manage environments
- Who can view project keys
Permission Hierarchy
- Team Admin - Full team control
- Team Developer - Can manage flags and settings
- Team Tester - Can test flags and other basic features
- Team Viewer - Can view flags
Understanding the permission hierarchy helps you assign the right roles to the right people.
External Teams and Projects
External Teams
Teams created by others where you're a member:
- Marked with "External" tag
- You have limited permissions
- You cannot delete the team
External Projects
Projects where you're a member (not the owner):
- Marked with "External" tag in project list
- Your permissions depend on your role
- You cannot delete the project
Best Practices
Team Organization
- Create by Department - Organize teams by department or function
- Clear Naming - Use descriptive team names
- Right Size - Don't make teams too large or too small
- Regular Review - Periodically review team membership
Member Management
- Start Small - Add members as needed
- Clear Roles - Assign appropriate roles from the start
- Document Permissions - Keep track of who has what access
- Regular Audits - Review member access periodically
Collaboration
- Use Teams for Groups - Create teams for departments or functions
- Project-Level Control - Manage project access separately
- Communicate Changes - Inform team when permissions change
- Document Access - Keep records of who has access to what
Security
- Principle of Least Privilege - Give minimum necessary permissions
- Regular Reviews - Audit team and project members regularly
- Remove Access Promptly - Remove members who no longer need access
Troubleshooting
Can't Add Members
- Verify you have permission to manage the team
- Check that you're the team owner or admin
- Ensure the email address is valid
- Try resending the invitation
Member Can't Access Project
- Verify the member is added to the project
- Check their project role and permissions
- Ensure they've accepted team invitation
- Verify project settings allow member access
Permission Issues
- Review team and project roles
- Check if member has necessary permissions
- Verify project settings
- Contact project/team owner if needed
Next Steps
Now that you understand teams: