Roles & Permissions

YardPilot uses a permission-based access control system to let you control exactly what each team member can see and do. Every user is assigned a role, and each role has a set of permissions that determine their access.

How It Works

• Permissions are specific actions (e.g., "Create Invoices", "View Reports")
• Roles are bundles of permissions assigned to team members
• System roles (Owner, Admin, Office, Field) come pre-configured
• Custom roles let you tailor access to your business needs

Click to enlarge

Configure exactly what each team member can access with granular permission controls

System Roles

YardPilot includes four system roles that cannot be deleted. These cover the most common access patterns for field service businesses.

Owner

Aspect	Details
Access	Full access to everything
Best for	Business owners, primary account managers
Unique abilities	Manage roles & permissions, access billing, delete company data

The Owner role bypasses all permission checks. There must always be at least one Owner per company.

Admin

Aspect	Details
Access	Full access except role management
Best for	Senior managers, operations directors
Restrictions	Cannot create/modify roles, cannot access billing

Admins can manage users, teams, and all operational aspects but cannot change who has what permissions.

Office

Aspect	Details
Access	Full CRM and operations access
Best for	Admin staff, schedulers, account managers
Key capabilities	Quotes, jobs, invoicing, scheduling, reports

Office users can perform most day-to-day operations but cannot:

• Close, reopen, or delete jobs
• Void invoices or process refunds
• Manage team access or roles
• Approve other users' expenses

Field

Aspect	Details
Access	Limited to field work operations
Best for	Technicians, field workers, contractors
Key capabilities	Start/complete visits, log time, view schedules

Field workers have view-only access to most areas and can only:

• View assigned work (contacts, properties, jobs)
• Start, complete, and skip visits
• Log their own time entries
• Submit their own expenses

Permission Categories

Permissions are organised into categories that match YardPilot's features:

Category	What it controls
Contacts	Customer records, import/export
Properties	Service locations, property details
Work Requests	Incoming work requests, conversion to jobs
Quotes	Estimates, sending, approval, conversion
Jobs	Work orders, assignments, lifecycle
Visits	Scheduled work, completion, time tracking
Invoices	Billing, sending, adjustments
Payments	Recording, allocation, refunds
Users	Team member management
Teams	Crew groupings
Settings	Company configuration
Roles	Permission management
Schedule	Calendar, routing
Reports	Analytics, exports

For a complete list of all permissions, see the Permission Reference.

Viewing Role Permissions

To see what permissions a role has:

1. Go to Settings (gear icon in sidebar)
2. Click Roles & Permissions
3. Click on any role in the list
4. The permission matrix shows all permissions, organised by category

Checked permissions are enabled for that role. The count (e.g., "5/8") shows how many permissions in each category are enabled.

Changing a User's Role

To assign a different role to a team member:

1. Go to Settings > Team Members
2. Click on the team member's name
3. Select a new role from the dropdown
4. Click Save

Changes take effect immediately. The user may need to refresh their browser to see the updated access.

Creating Custom Roles

If the system roles don't match your needs, you can create custom roles with exactly the permissions you want. See Creating Custom Roles for details.

Common Questions

Can I have multiple Owners?

Yes, you can have multiple users with the Owner role. This is useful when multiple people need full control over the business.

What happens when I change someone's role?

Their access changes immediately. Any pages they no longer have access to will show an error if they try to navigate there.

Can Field workers see all jobs?

Field workers can view jobs, but they typically only see jobs assigned to their team. The schedule view shows only their assigned visits.

Why can't I edit certain roles?

Only users with the Owner role can edit the Owner and Admin system roles. Admins can edit Office, Field, and custom roles.

Can I delete a system role?

No, system roles (Owner, Admin, Office, Field) cannot be deleted. You can only delete custom roles that you've created.

Next Steps

• Create a custom role tailored to your business
• View all permissions available in YardPilot
• Add team members to your account