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 financials
- Accountant who needs invoices but not projects
- 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"
- "Bookkeeper"
- "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 |
Financial
| Permission | Allows |
|---|---|
| View invoices | See incoming/outgoing invoices |
| Create invoices | Add new invoices |
| Record payments | Mark invoices paid |
| View reports | Access financial reports |
| Manage budget | Edit project budgets |
Team
| Permission | Allows |
|---|---|
| View team | See user list |
| Manage users | Invite, edit, remove users |
| Manage roles | Create/edit roles |
| View attendance | See clock in/out |
| Manage attendance | Edit time records |
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
- ✗ Financial access
- ✗ User management
Bookkeeper
Financial access only:
- ✓ View/Create invoices
- ✓ Record payments
- ✓ View financial reports
- ✓ View projects (read only)
- ✗ Takeoffs
- ✗ User management
Field Supervisor
Project and team focus:
- ✓ View projects
- ✓ Edit assigned tasks
- ✓ View/Upload documents
- ✓ View team attendance
- ✗ Quotes
- ✗ Financial details
Client Viewer
Read-only client access:
- ✓ View specific project
- ✓ View documents
- ✓ View quotes (sent to them)
- ✗ Everything 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
- Team - Manage your workforce