Skip to main content
View Categories

Conversion Kit: Partner Commission Report

The Partner Commission Report credits each booking to the partner site that referred it and tells you what you owe, after cancellations and refunds are netted out.


What it does #

If you run a referral or affiliate arrangement with partner sites, you need to know which bookings each partner actually sent you and how much they have earned, without paying out on a booking that later cancelled or has not happened yet. Pulling that together by hand from booking exports is slow and easy to get wrong.

The Partner Commission Report builds it for you from the bookings the Conversion Kit already tracks. Every booking that arrived with a partner source, either a source tag on the link the guest followed or, when there is no tag, the site that sent the guest, is credited to that partner and sorted into one of three buckets based on the booking’s current status:

  • Payable: confirmed, completed, or closed bookings. The partner is owed for these.
  • Excluded: cancelled, expired, refunded, declined, or no-show bookings, plus any booking from a site you have marked as not commissionable (see step 3). These are netted out and never paid.
  • Needs review: still-pending bookings, or any booking whose status could not be confirmed. These are held back from the payable total so a booking that has not really happened yet is never auto-paid.

The three buckets always add up to the gross total, so the numbers reconcile. For example, a guest who arrives from “Sunset Rentals Blog” and books a confirmed stay shows under that partner in the Payable bucket; if the stay later cancels, the same booking moves to Excluded and drops out of what you owe.

Many partners send guests from more than one website. You can put all of a partner’s sites into one partner group with a commission rate. The report can then be run and exported for the whole group at once, and it works out the commission owed: the payable booking value multiplied by the group’s rate. The report also shows a commission column on every source and every booking.

You can credit the first partner that referred the guest or the last partner before they booked, run the report for any date range to match a billing period, filter to a single partner or a whole group, and download the per-booking detail as a CSV to pay against. The CSV also carries the guest’s name and the confirmation code from your booking system, so your accountant can find each credited booking there without a second lookup.

How to turn it on #

1. Open the Attribution tab #

In Conversion Kit, open Insights, then the Attribution tab. The Partner Commission Report sits at the bottom of that tab, followed by the Partner Source Registry and Partner Groups editors.

2. Name your partner sources #

In the Partner Source Registry, list each partner site one per line as the source tag, a comma, then the display name. For example, sunset-blog,Sunset Rentals Blog. The tag is normally the source value on the partner’s links, but a partner that never tags its links is still credited automatically: the guest’s booking is attributed to the address of the site that sent them instead, turned into a tag by lowercasing it and swapping dots for dashes, so a referral from sunsetrentalsblog.com becomes the tag sunsetrentalsblog-com. You can name that tag the same way you name any other. Any source seen in bookings that you have not named yet, whether a tag a partner chose or one built from a referring site’s address, appears in a table of unregistered slugs with a booking count, so a new or misspelled partner is never missed.

Each line can also carry a group and a not-commissionable flag, in this order: tag,Display Name,group,inactive. For example, 101escapes-com,101 Escapes,vortex puts that site in the group vortex, and hi-tide-resort-com,Hi-Tide Resort,vortex,inactive also marks it as a site you own yourself. A site marked inactive still shows in the report, but it is netted out as Excluded and owes no commission. Save with Save Sources. The list is the full set, so deleting a line removes that source.

3. Set up a partner group (optional) #

In Partner Groups, give the group a name and a commission rate (a percentage from 0 to 100, for example 10). Leave the slug empty to have one made from the name, or type the slug of an existing group to update it. Paste the partner’s domains into the box, one per line, and select Save Group. A pasted CSV keeps only its first column. Each domain is added to the registry and placed in the group. A domain that is already registered keeps its name and its not-commissionable flag; a new one is named after its domain. A message confirms how many sites were loaded.

The table above the form lists each group with its slug, rate, and site count. Delete removes the group only. Its sites stay in the registry, ungrouped, and their bookings are then credited with a zero commission rate.

4. Choose the date range and crediting #

Set the report’s own From and To dates to match a partner’s billing period. Until you set them, the report follows the same date range as the 7, 30, or 90-day selector used elsewhere on the tab, so check them before running a payout if you have changed that selector. Pick last touch or first touch crediting. In the Source menu, choose All partners, a partner group (listed with its site count and rate), or a single source.

5. Export to pay against #

Use Download CSV to export every credited booking with its reservation, guest name, confirmation code, source, value, booking date, property, status, bucket, rate, and commission. The guest name and confirmation code come from your booking system and appear in the CSV only, not in the on-screen report. If a booking’s details cannot be looked up, those two cells are left blank and the booking still appears with its other columns.

Settings #

SettingWhat it controls
Partner Source RegistryThe list mapping each partner site’s source tag to a display name, one per line as tag,Display Name[,group[,inactive]]. Accepts a tag the partner’s links use, or the address-based tag HomeRunner builds for a partner that does not tag its links. This list is the full set, so removing a line removes that source.
Group (registry column)The partner group a source belongs to. Optional. A source with no group is credited but earns a zero commission rate.
Inactive (registry flag)Marks a site you own yourself, or any source you never pay. Its bookings stay visible but are netted out as Excluded and owe nothing. Default: every source is commissionable, including ones you have not named yet.
Group name and slugThe label shown in the Source menu, and the short key that identifies the group. Typing an existing slug updates that group.
Commission rate %The percentage of each payable booking’s value owed to the group, from 0 to 100. Default: 0 until you set it.
Group domainsThe partner’s websites, one per line, added to the group when you save.
CreditingWhether a booking is credited to the first partner that referred the guest or the last partner before they booked. Defaults to last touch.
Date rangeThe From and To dates the report covers, so you can match a partner’s billing period. Until set, it follows the date range selected for the rest of the tab.
SourceOptional. Limits the report to all partners, one partner group, or a single partner source.

Tips #

  • The Payable total only counts bookings whose current status is confirmed, completed, or closed, so it already reflects cancellations and refunds. Check the Needs review bucket for pending bookings before you pay.
  • Commission is calculated on payable bookings only, at the rate of the group the booking’s source belongs to. A source that is not in any group shows a commission of zero, so put every paid partner site into a group before you pay out.
  • If a partner lists a site that you own yourself, add it to the registry with the inactive flag instead of leaving it out. It stays visible in the report but can never be paid.
  • Watch the unregistered slugs table for partners you have not named yet. A slug like sunsetrentalsblog-com is a referring site that never tagged its links (its address with dots swapped for dashes); adding it keeps that referral credited to a real partner name instead of a raw slug.
  • When your accountant checks a payout, they can search your booking system for the confirmation code in the CSV instead of matching on dates and amounts. A blank code means the booking system did not return one for that reservation.
  • A partner is credited automatically even without a tagged link, from the site that referred the guest. Search engines, social networks, listing sites like the major OTAs, AI assistants, webmail, payment redirects, and traffic from your own site never count as a referral partner, and neither does a paid ad click. For the wider view of where your bookings come from, see Conversion Kit: Insights Dashboard, and the HomeRunner Conversion Kit Overview for the full feature list.