Team Management
Collaborate effectively by inviting teammates, assigning roles, and managing access across your testing projects.
Organization Structure
BugBrain uses a multi-tenant architecture where:
- Organization - Your company/team workspace
- Members - People in your organization
- Projects - Testing projects within organization
- Roles - Permission levels for members
User Roles
Member
Basic role for team contributors
Can do:
- Create and edit test cases
- Run tests and view results
- Access assigned projects
- Use features (Discovery, AI generation)
- View analytics
Cannot:
- Invite new members
- Change org settings
- Manage billing
- Delete projects
- Change others’ roles
Best for: QA engineers, developers, testers
Admin
Management role for team leaders
Can do:
- Everything Members can do, plus:
- Invite and remove team members
- Create and delete projects
- Configure integrations
- Manage organization settings
- View all projects
Cannot:
- Change billing/subscription (owner only)
- Access super admin features
- Delete the organization
Best for: QA managers, team leads, engineering managers
Owner
Full control of the organization
Can do:
- Everything Admins can do, plus:
- Manage subscription and billing
- Delete the organization
- Transfer ownership
Note: The person who creates the organization becomes the owner automatically.
Best for: Person responsible for billing and organization
Role Assignment: Start team members as Members and promote to Admin only when needed. This follows security best practices.
Inviting Team Members
Quick Process:
- Go to Team page
- Click “Invite Member”
- Enter email address
- Select role (Member or Admin)
- Click “Send Invite”
What happens:
- Invitation email sent
- 7-day expiration
- Recipient accepts and joins
Managing Members
Changing Roles
To promote or demote a member:
- Go to Team page
- Find the member
- Click role dropdown
- Select new role
- Confirm change
Effect: Immediate - permissions update right away
Removing Members
To remove someone:
- Go to Team page
- Find the member
- Click “Remove”
- Confirm removal
What happens:
- Immediate loss of access
- Their work (tests, etc.) remains
- Can be re-invited later
Important: Removing a member doesn’t delete their created content. Test cases, executions, and projects they created remain in the organization.
Project Access
Organization-Wide Access
By default, members can access:
- All projects in the organization
- All test cases and results
- All shared resources
Project-Level Permissions
Optionally restrict access:
- Go to Project Settings
- Click “Members” tab
- Enable “Restricted Access”
- Select who can access this project
Use cases:
- Confidential projects
- Client-specific testing
- Department isolation
Team Collaboration
Shared Test Cases
All test cases are shared with the team:
- Anyone can run tests
- Members can edit (unless restricted)
- See who created each test
- View edit history
Real-Time Updates
See what teammates are doing:
- Active test executions
- Recent test creations
- Latest changes
- Current activity
Comments and Notes
Collaborate on tests:
- Add comments to test cases
- Tag team members (@mention)
- Discuss failures
- Share insights
Audit Trail
Track all team actions:
- Who created what
- When changes were made
- What was modified
- Access history
Team Settings
Organization Profile
Configure organization details:
- Organization name
- Display logo
- Company information
- Contact details
Team Notifications
Control team-wide notifications:
- New member joined
- Member removed
- Role changes
- Organization updates
Default Settings
Set defaults for new members:
- Default role
- Initial projects
- Welcome message
- Onboarding checklist
Member Limits by Plan
| Plan | Max Members |
|---|---|
| Starter | 5 members |
| Growth | 15 members |
| Pro | Unlimited |
At Limit? Remove inactive members or upgrade your plan to add more team members.
Best Practices
1. Use Real Names Encourage team members to use real names and photos in profiles
2. Document Responsibilities Clearly communicate what each role means in your team
3. Review Access Regularly Quarterly audit of who has access and what role they need
4. Onboard Properly Give new members a tour of your testing organization
5. Remove Promptly Remove access immediately when people leave the team
6. Use Project Restrictions Restrict sensitive projects to need-to-know basis
Activity Tracking
Member Activity
View individual activity:
- Tests created
- Tests run
- Last login
- Active projects
- Recent contributions
Team Activity Dashboard
Organization-wide view:
- Most active members
- Project activity
- Collaboration patterns
- Usage trends
Performance Metrics
Track team effectiveness:
- Tests per member
- Pass rates by creator
- Response time to failures
- Coverage contributions
Communication
In-App Notifications
Members receive notifications for:
- @mentions in comments
- Test failures they created
- Assigned issues
- Important updates
Email Notifications
Configurable email alerts:
- Daily digests
- Failure alerts
- Weekly summaries
- Monthly reports
Integration Notifications
Team notifications via:
- Slack channels
- Microsoft Teams
- Email distribution lists
- Custom webhooks
Offboarding Process
When a team member leaves:
-
Remove Access
- Go to Team page
- Remove the member
- Access revoked immediately
-
Reassign Ownership
- Review their test cases
- Assign to other team member if needed
- Update project owners
-
Update Integrations
- Remove from Slack channels
- Update Jira assignments
- Clean up webhooks
-
Archive if Needed
- Archive old projects they owned
- Clean up unused resources
- Document handoff
Security Features
Access Control
- Role-based permissions
- Project-level restrictions
- Resource isolation
- Audit logging
Session Management
- Automatic timeout
- Multi-device support
- Force logout capability
- Session history
IP Restrictions
(Pro plan)
- Whitelist IP addresses
- Block access from untrusted networks
- VPN requirements
- Geographic restrictions
Troubleshooting
Can’t invite member?
- Check you’re an admin
- Verify member limit not reached
- Ensure email is valid
- Check invitation wasn’t already sent
Member can’t access project?
- Verify they’re not removed
- Check project restrictions
- Ensure they have correct role
- Ask them to logout and login again
Wrong permissions?
- Verify their role assignment
- Check project-level restrictions
- Review organization settings
- Contact support if issues persist