Custom Roles
Create tailored permission levels for your team.
Why Custom Roles?
Built-in roles (Admin, Manager, Employee) may not fit everyone:
- Estimator who needs takeoff but not settings
- Subcontractor with limited project access
Custom roles let you fine-tune permissions.
Creating a Custom Role
Go to Roles
Navigate to Settings → Roles.
Click New Role
Click + Create Role.
Name Your Role
Choose a descriptive name:
- "Estimator"
- "Field Supervisor"
- "Client Viewer"
Set Permissions
Check the permissions this role should have.
Save
Click Save Role.
Permission Categories
Projects
| Permission | Allows |
|---|---|
| View projects | See project list and details |
| Create projects | Start new projects |
| Edit projects | Modify project info |
| Delete projects | Remove projects |
| Archive projects | Archive/unarchive |
Takeoff
| Permission | Allows |
|---|---|
| View takeoffs | See takeoff results |
| Create takeoffs | Run AI detection, draw measurements |
| Edit takeoffs | Modify existing measurements |
| Export takeoffs | Download data |
Documents
| Permission | Allows |
|---|---|
| View documents | See uploaded files |
| Upload documents | Add new files |
| Delete documents | Remove files |
| Share documents | Send to others |
Quotes
| Permission | Allows |
|---|---|
| View quotes | See estimates |
| Create quotes | Build new quotes |
| Edit quotes | Modify quotes |
| Send quotes | Deliver to clients |
| Delete quotes | Remove quotes |
Team
| Permission | Allows |
|---|---|
| View team | See user list |
| Manage users | Invite, edit, remove users |
| Manage roles | Create/edit roles |
Settings
| Permission | Allows |
|---|---|
| Company settings | Edit company info |
| Billing | Access subscription |
| Integrations | Connect apps |
| API keys | Manage developer access |
Example Custom Roles
Estimator
Focus on takeoff and quotes:
- View/Create/Edit takeoffs
- View/Create/Edit quotes
- View/Upload documents
- No user management
Field Supervisor
Project and document focus:
- View projects
- View/Upload documents
- No quotes access
- No user management
Client Viewer
Read-only client access:
- View specific project
- View documents
- View quotes (sent to them)
- Nothing else
Assigning Custom Roles
Once created, assign to users:
- Go to Settings → Team
- Click user's name
- Select Change Role
- Choose your custom role
- Save
Editing Roles
- Go to Settings → Roles
- Click role name
- Modify permissions
- Save
Changes affect all users with this role immediately.
Deleting Roles
Before deleting:
- Reassign users to another role
- Role cannot have assigned users
To delete:
- Click role name
- Click Delete Role
- Confirm
Role Hierarchy
Permissions are cumulative with base access:
- Custom roles include basic app access
- Can't grant more than Admin level
- Owner permissions can't be assigned
Best Practices
Start Restrictive
Begin with minimal permissions:
- Add access as needed
- Easier than removing later
Document Your Roles
Keep notes on role purposes:
- Who should have this role
- Why these permissions
- When to review
Regular Reviews
Quarterly role audit:
- Are roles still appropriate?
- Do permissions match job functions?
- Any unused roles to delete?
Troubleshooting
Q: User missing expected access
- Check their role's permissions
- Verify role is correctly assigned
- Some features need multiple permissions
Q: Can't restrict Owner
Owner role is fixed and cannot be modified for security.
Q: Role changes not taking effect
User may need to refresh their browser or log out/in.
Next Steps
- User Management - Assign roles to users
- Settings Overview - Other configuration