A guide to configuring deferred commissions, understanding when they finalize, and viewing them as a manager or salesperson.
Overview
A deferred commission is commission for membership sales that a salesperson does not immediately earn at the moment of sale. Instead, it only appears on commission reports if the following conditions are true:
- A waiting period that you have set (30-90 days) has elapsed
- The membership is still considered active
- The original transaction is still qualified
This rewards salespeople for selling memberships to customers that retain them long-term, and disincentivizes salespeople from encouraging customers to “sign up and cancel”.
Setting up deferred commissions involves two layers of configuration:
- Tenant settings — define how long the waiting period is (the deferral period).
- Commission item settings — define how much of a given commission item is deferred.
Setting Up Deferred Commissions
| Available to: Tenant Admins |
Step 1: Set your Deferral Period
The deferral period is a single, tenant-wide setting. Every location in the tenant uses this same waiting period.
- Navigate to Settings > Tenant Settings > Commission Deferral.
- Drag the Deferral Period bar or enter a value for the deferral period in days.
This setting controls how many days must pass after a sale's wash date before its deferred commission is eligible to be finalized. Allowed range: 30–90 days (Default: 30 days).
Step 2: Set Deferral Amounts for Each Commission Item
Deferral is configured per commission item. For each item, you can choose to defer commission dollars, Salespath points, and XP.
- Navigate to Settings > Commission Plans.
- Find a commission plan and select Edit.
- Find a commission item and select Edit.
- Enter values in the Deferred Commission, Deferred Points, and Deferred XP fields.
- Click Save.
| Field | What it sets |
|---|---|
| Deferred Commission | The dollar amount earned once the deferral period passes, instead of at the time of sale. |
| Deferred Points | The number of points earned once the deferral period passes, instead of at the time of sale. |
| Deferred XP | The amount of XP earned once the deferral period passes, instead of at the time of sale. |
Note: If all three are left at zero, the item behaves as a normal (immediate) commission item.
The Deferred Commission Lifecycle
Each deferred commission moves automatically through a simple lifecycle without requiring manual action. It is important to note, however, that we only surface deferred commissions in a few places in the UI.
Step 1: A sale creates a pending deferred commission
When a salesperson sells a deferred-eligible commission item, the system automatically creates a companion deferred transaction in the Pending state.
- Deferred wash date = original sale's wash date + Deferral Period (days).
- Example: A sale washing June 1 with a 30-day deferral period gets a deferred wash date of July 1.
- This is an internal status that is not visible in the UI
Step 2: The finalization sweep evaluates pending deferrals
A finalization sweep runs nightly as part of regular membership/MRR import processing. It evaluates Pending commissions whose deferred wash date has elapsed based on two checks:
| Check | Requirement |
|---|---|
| Membership still active | Customer membership must still be active (no end date) at the time of the sweep. |
| Original sale qualified | The parent sale must still be marked as qualified. |
Based on this criteria, the follow actions takes place:
| Outcome | When | Result |
|---|---|---|
| Accepted | Both checks pass. | Commission, points, and XP are awarded and earned. |
| Skipped | Either check fails. | Commission is forfeited. Shown in reports for transparency only. |
In other words, when a deferred commission is accepted, Salespath points and XP are awarded to the user that is attributed to the original transaction. Additionally, the deferred commission amount will now appear in the Commission Report (for Admins and Managers) and the Salesperson Dashboard.
| ℹ️ Note on Attribution: A deferred commission never holds its own salesperson attribution — it always follows the original sale, both before and after it finalizes. While the deferred amount is still pending, a change to the sale's attribution simply means it finalizes to the sale's current owner. If the attribution changes after the deferred amount has already finalized, the system automatically reverses the deferred commission, points, and XP from the previous salesperson and re-credits them to the new one (or removes them entirely if the sale is reassigned to "No One"). Either way, no manual re-attribution is needed — the deferred commission stays in sync with whoever owns the original sale. |
How Deferred Commissions Impact Reports and Dashboards
Commissions Report
The Commissions Report (Reports > Commissions) includes deferred commissions as a dedicated row in the Commission Type table, alongside other commission types. This row displays the number of deferred commissions and the total commission earned on those transactions, which rolls up into the report's grand total.
Opening the Transaction Details displays a separate transaction-level table with details of each deferred commission:
| Column | Description |
|---|---|
| Deferral Date | The date the commission was deferred |
| Original Sale Date | The date of the original wash transaction |
| Status | The current status of the deferred commission (see below) |
| Salesperson | The Salesperson attributed to the sale |
| Deferred Amount | The commission amount tied to the deferred transaction |
| Details | Expands to show the original transaction details linked to this deferral |
Clicking Details opens a panel showing the parent transaction — the original wash this deferred commission is tied to.
Deferred Commission Statuses
Deferred commissions will almost always show a status of Accepted. A deferred commission is marked Skipped if any of the following occurred before the commission was finalized:
- The parent transaction was disqualified
- Attribution was changed to a different salesperson
- Attribution was changed to unattributed
Skipped deferred commissions are not shown by default.
Salesperson Dashboard
The Commission Card on the Salesperson Dashboard displays an estimated deferred commission amount alongside the salesperson's earned commission for the selected period.
How It Appears
The deferred commission amount appears in parentheses next to the earned commission total on the Commission card. For example, a salesperson who earned $20 today with $10 in estimated deferred commission would see both values displayed together.
Hovering over the card displays a tooltip:
Estimated deferred commission you'll earn from this period's sales, if they are accepted.
This same display applies to both the Today and Last 7 Days views on the dashboard — each reflects the deferred commission earned within that respective time window.
Why the Amount Is Estimated
Deferred commissions typically don't finalize for at least 30 days. The amount shown is an estimate because the final value depends on whether the associated transactions are accepted. The amount could be reduced if:
- Attribution is changed to another salesperson or to unattributed
- There is an issue with the AI summary for the transaction
Until the commission finalizes, the card reflects the maximum potential deferred amount the salesperson could earn from that period's sales.
Quick Reference
| Question | Answer |
|---|---|
| How long is the deferral period? | Set per tenant via "Deferral Period (days)" (30–90 days). |
| What is the acceptance criteria for a deferred commission? |
|
| How do I add deferred commission to a commission item? | Set a non-zero amount for Deferred Commission, Points, or XP on the commission item. |
| When does it pay out? | Well, we don’t payout, but we will surface the commission in the Commission Report after the period passes and the deferred commission has been finalized |
| What if the customer cancels their membership? | When the deferred commission is finalized, we will mark it as Skipped internally, which will prevent the deferred commission from being visible in the Commission Report and the Salesperson dashboard |
| Where is deferred commission visible? | Dashboard (Salespeople) or Commission Report (Managers). |
Comments
0 comments
Article is closed for comments.