Documentation Index

Fetch the complete documentation index at: https://help.servicetitan.com/llms.txt

Use this file to discover all available pages before exploring further.

Earnings Codes Home

Prev Next
Core Product

Earnings Codes

Earnings codes act as a bridge between your payroll data and your payroll processor — helping you export payroll data accurately and with less manual effort.

Product overview

See Earnings Codes in action

Watch how earnings codes connect ServiceTitan pay activities to your payroll processor's codes, reducing manual work and minimizing mistakes.

Setup

Earnings codes allow you to save time, minimize mistakes, and improve payroll efficiency by matching ServiceTitan pay activities to your provider's codes.

Setup checklist

Set up Business Units

Ensure all Business Units (BUs) are properly configured in your system before adding earnings codes.

Confirm technician Business Unit assignments

Confirm that each technician is assigned to the correct Business Unit in their profile.

Assign Payroll Business Unit for office employees

Select the appropriate Payroll Business Unit from the Payroll tab in each office employee's profile.

Configure Timesheet Codes (Legacy Timekeeping)

If using Legacy Timekeeping: create and configure Timesheet Codes to track non-job activities.

Create Timesheet Activities (Flexible Timekeeping)

If using Flexible Timekeeping: review and create Timesheet Activities to define how time is categorized and matched with earnings codes.

Required permissions

The View and edit payroll codes permission is required to access the earnings codes tab. Administrators have required permissions by default.

Once setup is complete

Export payroll reports with your processor's earnings codes to simplify and speed up payroll processing.

Quick Start Guide — Earnings Codes

Note: This feature requires account configuration. Please contact Technical Support for details. Your payroll processor's earnings codes may vary depending on your account configuration and payroll policies.

Step 1: Create earnings codesCreate earnings codes to align with your payroll processor's structure.

Step 2: Assign earnings codes — Assign earnings codes to Business Units (used mainly for technicians working on jobs), Timesheet Codes (used to track activities like breaks or office employee hours), and Payroll Adjustments (used for manually adjusting pay, such as adding a bonus or making a correction).

Key workflows

Core workflows for using Earnings Codes.

Run payroll reports with earnings codes

Export payroll reports with your processor's earnings codes to simplify and speed up payroll processing.

FAQ

Common questions about earnings codes setup and usage.

Frequently Asked Questions

What permissions are required to manage earnings codes?

The View and edit payroll codes permission is required to access the earnings codes tab. To set up and manage earnings codes, the following permissions must be enabled:

Can access global payroll settings

View business units

Edit business units

View or update payroll tab on technician edit

Administrators have these permissions by default. To enable them for other roles, contact your team's account administrator.

What can earnings codes be assigned to?

Earnings codes can be assigned to three areas to support accurate payroll data mapping:

Business Units (BUs) — Used mainly for technicians working on jobs.

Timesheet Codes — Used to track activities like breaks or office employee hours.

Payroll Adjustments — Used for manually adjusting pay, such as adding a bonus or making a correction.

Does advanced setup require contacting support?

Yes — the advanced setup feature requires account configuration. Please contact Technical Support for details. Your payroll processor's earnings codes may vary depending on your account configuration and payroll policies, so it is also recommended to contact your payroll processor for specifics.