Service Titan Knowledge Base

Configure your account for marginal range bonuses (scaffolded bonuses)Last updated on 10/25/2022


Things to know

  • You may set as many range bonus levels as you like.

  • Marginal range bonuses are based on invoice subtotals if all items on the invoice are marked as Pays Commission (the sum of all invoice subtotals for the pay period). Therefore, items on the invoice need to be marked as commissionable. Marginal range bonuses will not be calculated at the individual invoice level.

  • Configured business unit fees and job costs will be deducted from marginal range bonuses.


How range bonus calculations will change when you enable marginal range bonuses:

For example, if you apply a 5% range bonus for sales between $0 to $500, and a 7% range bonus for sales between $501 to $1000, the 5% bonus will always be applied to the first $500, and the 7% bonus will be applied only to the amount that exceeds $501 up to $1000.

Sample Calculation:

If you apply a 5% range bonus for sales between $0 to $500, and a 7% range bonus for sales between $501 to $1000, the 5% bonus will always be applied to the first $500. The 7% bonus will be applied for the remaining amount that exceeds $501 to $1000.

In this case, the range bonus for $600 in sales would be calculated as follows: ($500 * 5%) + [($600-$500) * 7%) = $32.

In the above example, if you add a range bonus of 10% for sales between $1001 to $2000, the range bonus for $1500 in sales would be calculated as follows: ($500 * 5%) + [($1000 - $500) * 7%] + [($1500-$1000) * 10%] = $110.


Changes to the Payroll (Detail) Report:

When this feature is configured for your account, you will see some changes to the Payroll (Detail) Report.

  • Range bonuses will no longer be applied to individual invoices. This means that marginal range bonuses will not be reflected in the Invoices section of the Payroll (Detail) Report. This is for cleaner reporting, since marginal range bonuses are dependent on totals for the pay period.

  • The lowest range bonus percentage will be applied to commission-based payroll adjustments, unless the adjustment amount exceeds the lowest range bonus level. Click here for more information on commission-based payroll adjustments.


Where to find marginal range bonuses on the Payroll (Detail) Report:

You will see the marginal range bonuses applied in the Totals section only. Marginal range bonuses are applied in Net Commission and Total Gross Pay.


Calculate Range Bonus

The Payroll Detail report should be set to the full date range if you want to see the Range Bonus calculated in your report. This feature helps users easily make their bi-weekly and monthly range bonuses. Note: To access the Payroll Detail Report, go to Reports > Search > Payroll Detail Report.

For example, technician Cal Morrison should receive a 10% bonus for the week of 3/11-3/17 because he has generated $999 of revenue. But when running the Payroll Detail Report for the day of 3/11, he only receives a bonus of  5% on a total of $499. Note: The Range Bonus appears in the GP column.

To check a range bonus:

  1. In ServiceTitan, go to the navigation bar and click Settings > People > Technicians.

  2. Select the technician.

  3. Click Edit.

  4. In the Payroll tab, check the Range Bonuses set.

  5. If you see that a technician receives the correct commission for the date range of 3/11-3/11, widen the date range from 3/11-3/17 to include all applicable revenue and generate the 10% range bonus. Then, the bonus is calculated correctly.

To see the Range Bonus calculated, you need to set Range Bonuses to a higher number. For example, technician Cal Morrison is receiving no Range Bonus for the week of 3/11-3/17.

  1. In ServiceTitan, go to the navigation bar and click Settings > People >Technicians > Edit.

  2. Check the upper limit.

  3. If the upper limit of his Range Bonus is set to $10,000 and when you run the Payroll Detail Report for 3/11-3/17, you see that the technician has sold more than $10.000. Therefore, he will not get a bonus.

    Tip: Make the upper limit of the final Range Bonus a very large number, such as $1,000,000.


Want to learn more?


Important note: Some features may not be currently included in your account and additional configuration may be required. Please contact technical support for details.


Disclaimer: Information provided in this article is for informational purposes only and it should not be construed to be legal advice. Information provided in this article may also not constitute the most up-to-date legal or other information. You should not act or refrain from acting on the basis of any information in this article to meet any compliance requirements without seeking independent legal or other professional advice.