Managing Roles
Change team member roles and permissions
Managing Roles
Admins can change team member roles to adjust permissions as your team evolves.
Understanding Roles
Member Role
Standard access for most team members:
- Create and edit documents
- Participate in sign-offs
- Add comments
- Cannot manage team or billing
Admin Role
Full access for team leaders:
- All Member permissions
- Invite/remove team members
- Change user roles
- Connect integrations
- Manage billing
Changing a User's Role
Step 1: Access Team Settings
- Navigate to Dashboard > Settings
- Find the Team Members section
- Locate the user you want to modify
Step 2: Change the Role
- Find the role dropdown or menu next to the user
- Click the dropdown
- Select the new role (Admin or Member)
- Confirm the change
Step 3: Notification
- The user may receive a notification
- New permissions take effect immediately
- No action required from the user
When to Promote to Admin
Consider promoting to Admin when someone needs to:
- ✅ Invite new team members
- ✅ Remove departing team members
- ✅ Manage billing and subscriptions
- ✅ Set up integrations (like GitHub)
- ✅ Make organizational decisions
When to Demote to Member
Consider changing Admin to Member when:
- The person no longer needs admin privileges
- They've changed roles within the organization
- You're reducing the number of admins for security
- They requested fewer permissions
Cannot Demote Yourself: You cannot change your own role from Admin to Member. Another Admin must do this.
Minimum Admin Requirement
- Every organization must have at least one Admin
- You cannot demote the last Admin
- If the last Admin needs to leave, first promote someone else
Role Change Scenarios
New Team Lead
- Person joins as Member
- Later promoted to team lead position
- Admin promotes them to Admin role
- They can now manage the team
Temporary Admin Access
- Person needs to set up GitHub integration
- Admin promotes them temporarily
- After setup, Admin demotes back to Member
Departing Manager
- Current Admin is leaving
- Another person is promoted to Admin first
- Then the departing person can be removed or demoted
Permissions Matrix
| Action | Member | Admin |
|---|---|---|
| Create documents | ✅ | ✅ |
| Edit any document | ✅ | ✅ |
| Delete own documents | ✅ | ✅ |
| Delete others' documents | ❌ | ✅ |
| Request sign-offs | ✅ | ✅ |
| Respond to sign-offs | ✅ | ✅ |
| Add comments | ✅ | ✅ |
| View team members | ✅ | ✅ |
| Invite members | ❌ | ✅ |
| Remove members | ❌ | ✅ |
| Change roles | ❌ | ✅ |
| Connect GitHub | ❌ | ✅ |
| Manage billing | ❌ | ✅ |
| View billing | ❌ | ✅ |
Best Practices
Principle of Least Privilege
- Only grant Admin when necessary
- Default to Member role
- Regularly review who has Admin access
Multiple Admins
- Have at least 2 Admins
- Prevents lockout if one is unavailable
- Distributes responsibility
Document Role Changes
- Keep track of who has Admin access
- Note reasons for promotions
- Review quarterly
Communicate Changes
- Let users know when their role changes
- Explain new capabilities or limitations
- Provide training if needed
Troubleshooting
Can't Change Role
Check:
- You are logged in as Admin
- You're not trying to change your own role
- There will still be at least one Admin
Role Change Not Taking Effect
Try:
- Ask the user to sign out and back in
- Refresh the page
- Check if the change was saved
Need to Change Last Admin
- Create a new user (even temporarily)
- Promote them to Admin
- Now you can demote the original Admin
- Remove the temporary user if not needed