# Commission (/docs/plugins/commission)



The **Commission** plugin is for paying your own people a share of the bookings they bring in: the dock hand who sends guests to your site, the guide a returning customer asks for, the person at the counter who makes the sale.

It gives you four things:

* **A list of people**, each with the percentage they earn.
* **A custom field for your booking site** that lists those people, so a guest can say who helped them.
* **A way for your team to credit people** on any booking, when they create it or afterwards.
* **A commission report** showing what you owe each person, with approval by a manager if you want it.

This is a **feature** plugin, so there is nothing to connect.

<Callout type="info">
  Commission is separate from the [Affiliates](/docs/plugins/affiliates) plugin, which is for partners such as hotels that book for you. You can use either or both. They do not affect each other: a booking can carry an affiliate and commission people, and each has its own report.
</Callout>

How commission works [#how-commission-works]

* **Each person has one rate**, a percentage from 0 to 100 with up to two decimals. There are no flat amounts.
* **Each person credited on a booking earns their own rate in full.** If a guest picks two people, both earn their percentage of that booking. The commission is not split between them.
* **The percentage applies to** the booking's price after discounts, add-ons included. Tax, fees, tips and trip protection are left out. If your team lowers a booking's price by hand, with a price adjustment or a write-off, the commission drops in proportion.
* **Only confirmed bookings earn.** A canceled booking earns nothing, even when you kept a cancellation fee.
* **A refund lowers commission only when it is written off.** If you refund with **Write off the refunded amount** ticked, the booking's price drops and the commission drops with it. If you refund without it, the customer still owes that amount, the price has not changed, and neither has the commission. See [Refunds](/docs/payments/refunds).
* **A booking paid with an activity voucher earns no commission.** Nobody can be credited on one.
* **A rate is fixed when the person is credited.** Every credit keeps the rate it was given. A rate you change applies to bookings credited from then on.

<Callout type="info">
  The plugin tells you what you owe. It does not pay anyone and it does not record payouts. You pay your people the way you do today, from the report.
</Callout>

Setup [#setup]

1. Open **Plugins → Browse Plugins** and click **Install** on **Commission**.
2. On the setup page, add your people (described below).
3. Click **Enable**. Do this at each location that should use the plugin.
4. Add a **Commission person** field to the activities where guests should be asked. See [Asking guests on your booking site](#asking-guests-on-your-booking-site).

Your people belong to your **company**. You set them up once, and they are available at every location where the plugin is enabled.

Commission is managed from its setup page. It does not add a page of its own to the Plugins menu. To come back to it, open **Plugins → Browse Plugins** and click **Set up** on **Commission**.

Add your people [#add-your-people]

Enter a **Name** and a **Commission** percentage, then click **Add person**.

| Field           | Description                                                                                                                                          |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**        | What guests see on your booking site and what appears on bookings and in the report. Each name must be different, and a name cannot contain a comma. |
| **Commission**  | What this person earns, as a percentage of the booking.                                                                                              |
| **Team member** | Optional. The dashboard user this person signs in as. See [Linking a person to a team member](#linking-a-person-to-a-team-member).                   |

These are names to pick from, not accounts. Nobody gets a sign-in from being on the list, and a person does not need to be a user of your dashboard.

* To change someone's name or rate, click **Edit** beside them. A new rate applies to bookings credited from then on.
* When someone leaves, edit them and untick **Active**. They stop being offered to guests and to your team. What they already earned stays in the report.
* Someone who has never been credited can be removed. Someone with bookings can only be made inactive, so your reports keep their name.

Linking a person to a team member [#linking-a-person-to-a-team-member]

If someone on your Commission list also signs in to your dashboard, choose them under **Team member** when you add the person, or click **Edit** beside the person later.

* When that team member creates a booking, their own name is already ticked under **Commission**, so the booking they enter is credited to them without an extra step.
* It is a starting point, not a rule. They can untick their name or tick someone else before saving the booking.
* A team member can be linked to one person, and a person to one team member.
* The link only affects bookings created in the dashboard from then on. It does not change what guests see on your booking site, and it does not credit anyone on existing bookings.
* Someone who never signs in needs no link. Leave **Team member** empty.

Where commission is approved by a manager, a credit a team member gives themselves waits for approval like any other.

Automatic, or approved by a manager [#automatic-or-approved-by-a-manager]

**Apply commission automatically** decides what happens when someone is credited.

| Setting              | What happens                                                                             |
| -------------------- | ---------------------------------------------------------------------------------------- |
| **On** (the default) | A person is owed their commission as soon as they are credited on a confirmed booking.   |
| **Off**              | Each new credit waits until a manager approves it. Until then it is not counted as owed. |

* The setting belongs to the **location** you are working in. Each location can choose differently.
* Changing it affects credits made from then on. Credits that are already waiting stay waiting until someone decides them.
* A manager is anyone with the &#x2A;*Commission (approve)** permission. When a manager credits someone themselves, that credit is approved as they add it.

See [Approving commission](#approving-commission) for where a manager does this.

Asking guests on your booking site [#asking-guests-on-your-booking-site]

With the plugin enabled at a location, the custom field types for its activities include **Commission person**.

1. Go to **Activities > \[Activity Name] > Settings > Custom Fields** and click **Create New Field**.
2. Choose **Commission person**. The label starts as "Who helped you today?" and you can change it to anything.
3. Under **Selection**, choose how many people a guest can pick.
4. Under **People**, choose who is listed.
5. Decide whether the field is **Required**, and save.

| Setting       | Choices                                                                                                                                                                                |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Selection** | **One person**: the guest picks one name from a dropdown. **Several people**: the guest ticks everyone who helped, and each of them earns their own commission.                        |
| **People**    | **Everyone on your Commission list**: every active person, including anyone you add later. **Only specific people**: just the ones you tick, for example the guides who run that tour. |

On your booking site the field looks like a [dropdown or a multi-select](/how-to/activities/add-custom-fields#dropdown-and-multi-select-options) listing the names, in alphabetical order. Guests never see a rate.

When the guest completes the booking, each person they picked is credited at their current rate. The pick also appears with the booking's other answers, on its **Questionnaire** tab and in emails that include custom field answers.

<Callout type="warn">
  A Commission person field is hidden from your booking site when it has nobody to offer: when the plugin is turned off at that location, or when none of the people it lists is active. Guests are not asked and the booking goes through without it, even if the field is marked required. The **Custom Fields** tab shows a note on a field that is hidden for this reason.
</Callout>

Crediting a booking your team enters [#crediting-a-booking-your-team-enters]

Bookings your staff create are not asked custom fields, so your team credits people directly.

**When creating a booking.** With the plugin enabled at the location, the New Booking page (**Bookings > Create**) has **Commission** under **More Options**. Tick everyone who should be credited. Leave it empty to credit nobody. If you are [linked to a person on the list](#linking-a-person-to-a-team-member), your own name starts ticked.

**On an existing booking.** Open the booking's **Misc** tab. The **Commission** card shows who is credited and whether each credit is approved, waiting or declined, and whether the guest picked that person or your team added them. The pencil changes it:

* Whoever stays keeps the rate and the approval they already have.
* Anyone you add gets their current rate. Where commission is approved by a manager, their credit waits for approval.
* Anyone you untick is no longer credited on the booking.

Each change is recorded in the booking's history with who made it.

This is also how you fix a wrong pick: open the card, untick the person the guest chose by mistake, and tick the right one.

Approving commission [#approving-commission]

Open **Reports > Financials > Commission**. Someone with the &#x2A;*Commission (approve)** permission sees a **Needs approval** list at the top whenever credits are waiting at that location.

* The list shows every credit that is waiting, whatever trip dates the report below is set to, oldest first.
* Each row shows the person, the booking, the trip date and what the credit is worth.
* **Approve** counts it as owed. **Decline** means the person earns nothing for that booking.
* **Approve all** approves everything waiting at the location.

A decision can be changed later. In the **Credits** list further down, a manager can decline a credit that was approved, or approve one that was declined. This works for credits that were applied automatically too.

You can also decide from the booking itself. On the booking's **Misc** tab, the **Commission** card shows **Approve** and **Decline** beside each person to anyone with &#x2A;*Commission (approve)**, on the same terms as the report.

Only credits on confirmed bookings are listed for approval.

The Commission report [#the-commission-report]

Open **Reports > Financials > Commission**. The report is listed at locations where the plugin is enabled.

* **From** and **To** go by **trip date**, not the date the booking was made.
* **Show** narrows the report to one person.
* **Commission Owed** is what approved credits on confirmed bookings add up to.
* **Awaiting Approval** is what the credits still waiting would add, and how many there are. It is not part of what you owe.
* **Bookings** and **Commissionable Sales** count each booking once, even when it credits several people. Commissionable sales is what the percentages are taken from.
* **People** lists each person with their bookings, sales, what they are owed and what is awaiting approval.
* **Credits** lists each person credited on each booking in the range, with its status.
* **Export CSV** downloads the credits.

The report covers the location you are working in. It always reflects each booking as it stands now: cancel a booking, write off a refund, or decline a credit, and what is owed changes the next time you open the report.

Permissions [#permissions]

* **Setting up people and the approval setting** requires the **Plugins** permission. Administrators have every permission automatically.
* **Adding a Commission person field to an activity** requires **Activities: Edit**.
* **Crediting people on a booking** requires **Bookings: Edit**. Anyone with **Bookings: View** can see who is credited.
* **The Commission report** requires the **Reports** permission. The percentages on a booking's Commission card are shown only to people who have it.
* **Approving or declining** requires &#x2A;*Commission (approve)**. Nothing else grants it, including Reports and Plugins.

See [Employees](/docs/team/employees#permissions) for how permissions are granted.

Good to know [#good-to-know]

* **Report only.** Nothing is paid out and no payout is recorded. If you need to mark a period as paid, keep that in your own records.
* **No notification is sent** when a credit starts waiting for approval. Managers see what is waiting when they open the report.
* **Renaming a person** changes their name in the report and on bookings' Commission cards. The answer a guest gave keeps the name they saw at the time.
* **Changing the activity on a booking, or deleting the field,** removes the guest's answer as it does for any custom field. The people already credited stay credited, and stay on the booking's Commission card.
* **Partner channels do not ask this field.** Resellers connected through [OCTO](/docs/plugins/octo) are never shown a Commission person field, and a required one does not stop them selling the activity.
* **Affiliate devices and partner sites** show the field like any other custom field on the activity.
