Skip to main content
A commission rate is what your marketplace charges a seller on a sale. Each rate carries a charge, which is either a percentage of the sale or a flat fee per unit, and the conditions deciding which sales it applies to. A marketplace usually has more than one rate: a standard charge on everything, and narrower rates charging differently for one category, one seller or sales above a certain value. The rates sit in an ordered list, and the first one matching is the one charged. Rates are configuration rather than records. Editing one changes what the next sale is charged and never what a past one was, because the fee charged on an order is written once when the order is placed and is never worked out again. To manage them, navigate to Sellers → Commission rates in the admin dashboard.

Reviewing Your Commission Rates

The Commission rates list, in the order they are applied The list shows one row per rate, in the order they are tried. The order of the rows is the order of priority. There is no priority number to set: the first rate whose conditions match is the one charged, and the rest are not consulted. Rows are dragged to reorder them.

How a Rate Is Chosen

A rate is chosen for each item sold rather than for the order as a whole, so one order can be charged by several rates. The marketplace walks the enabled rates from the top of the list and takes the first one whose conditions admit that item and whose charge can be made in the order’s currency. A rate with no conditions matches everything, which is how a marketplace states a single standard charge. That rate belongs at the bottom of the list, because nothing below a rate that matches everything is ever reached.
Where no rate matches an item, no commission is charged on it and the seller keeps the sale, less any consumer tax your marketplace remits. Narrowing every rate with conditions and leaving nothing to catch the remainder is the way a marketplace stops earning without anything appearing to be wrong.
Two kinds of sale are never commissioned. Products your own team sells are the marketplace’s own and carry no fee, and the seller charged is the one recorded against the item when the order was placed rather than whoever owns the product today.

How to Create a Commission Rate

The Add commission rate form
  1. Click Add commission rate.
  2. Enter a Name, and a Code if you want your own identifier for it.
  3. Choose the Charge, which is either a percentage of the sale or a flat fee.
  4. Enter the value. A percentage takes one figure, up to 100, and a flat fee takes an amount per currency, charged for every unit sold.
  5. Add any Conditions, described below. A rate with none charges every sale.
  6. Set whatever else the rate needs from the fields below the conditions, described under Other Settings.
  7. Click Create commission rate.
The new rate appears at the top of the list and starts charging immediately. The top is the right place for most new rates, because a rate is usually created to charge something differently from the rates already there, and it has to sit above them to be reached. The exception is a rate with no conditions, which charges everything and stops the search. That one belongs at the bottom, and a new one has to be dragged there.
With a flat fee, a currency left empty is one this rate does not charge, and sales in that currency fall through to the next rate instead. A percentage is a ratio rather than an amount, so it charges in every currency.

Conditions

Conditions narrow which sales a rate charges. Every condition on a rate has to hold, and a condition naming several records matches any of them. Sale value is measured per item, on the same figure the fee itself is charged on, so a band and the charge it governs always weigh a sale the same way. The minimum is included in the band and the maximum is not, which lets two bands meet at a number without overlapping or leaving a gap. A rate charging 15% below 50 and one charging 10% from 50 upwards are two rates, each holding one of these.
A condition that names nothing never matches, so a half-filled condition takes the rate out of use rather than widening it. A Seller condition with no sellers chosen charges nobody. Make sure to enter values for any conditions added to a rate.

Other Settings

  • Floor and cap (optional) - On a percentage rate, the least and the most it will ever charge, set per currency. These are amounts rather than ratios, so each holds only in the currency it was written in, and a sale in a currency with neither set is charged without limit.
  • Maximum per sale line (optional) - On a flat fee, a ceiling on what one line can be charged. A flat fee is charged in full for every unit sold, so on a cheap item it can come to more than the seller made on the sale, and this is what stops that.
  • Tax on commission - The tax charged on the commission itself. Your fee is a separate supply to the seller, so this is added on top of the fee rather than taken out of it, and the two are invoiced and reported apart. Leaving it empty uses the default under Marketplace Settings.
  • Charge on delivery - Whether commission is also charged on what the seller collected for delivery, rather than on the goods alone. Available on a percentage rate only, since a flat fee is charged per unit sold and has no sensible reading on a parcel.
  • Charge on the gross price - Whether commission is charged on the price including the customer’s tax. Left off, it is charged on the seller’s net revenue, which is the usual basis where your fee is taxed as its own supply. Discounts come off the figure either way.
  • Enabled - A disabled rate is skipped when a sale is charged, without being deleted.

How to Change Which Rate Takes Priority

A rate’s position in the list is its priority. The marketplace reads the list from the top and charges the first rate that matches, so a rate higher up outranks every rate beneath it, and the highest one that matches an item is the only one consulted for that item. Dragging a commission-free rate above the standard rate
  1. Navigate to Sellers → Commission rates.
  2. Grab the handle at the start of a row.
  3. Drag it up to raise its priority, or down to lower it.
The new order takes effect on the next sale. Nothing already charged changes. The general rule for ordering is that the narrower the conditions of the rate are, the higher it belongs. A rate charging one category differently has to sit above the rate charging everything, because the broad rate would otherwise match first and the narrow one would never be reached. Priority is the only thing deciding this, so a narrow rate placed below a broad one is simply inactive. These setups all depend on the order:
  • Commission-free products. A rate charging 0% with a Product or Category condition, placed at the top, trades the named goods for nothing. Below it, the standard rate charges everything else.
  • A negotiated rate for one seller. A rate charging 5% with a Seller condition, above a standard rate charging 10%. The named seller is charged 5% and everybody else falls through to 10%.
  • Rates that vary with the value of the sale. A rate charging 15% below 50 above a rate charging 10% from 50 upwards, with the standard rate below both. The first band to match wins, which is why the bands are ordered rather than given priorities of their own.
  • A standard rate. One rate with no conditions, at the bottom, catching everything the rates above did not.
Raising a percentage rate with no conditions above the others turns off everything beneath it, because it matches every sale in every currency and ends the search. A flat fee does not reach quite that far, since it is skipped for a currency it states no amount in, and the rates below it still apply to those sales. The list stays as it was and nothing warns you, so the effect only shows up in what the next sales are charged.

How to Edit or Delete a Rate

A rate can be edited or deleted at any time, from the menu at the end of its row. To edit one, click Edit. The same fields open as when the rate was created, and saving changes what the next sale is charged. Commission already charged is untouched, so editing a rate is never a way to correct a fee on an order that has already been placed. To delete one, click Delete and confirm. Commission already charged on past sales is not affected either, so deleting a rate changes what future sales are charged rather than rewriting what has happened. The rate itself stays readable behind the commission it charged, so an old order can still say which rate produced its fee.
Deleting a rate can leave sales with no commission at all. Where nothing below it matches, the sales it was charging fall through the rest of the list and are charged nothing, and the seller keeps the whole amount. Check that a rate with no conditions is sitting at the bottom of the list before deleting anything above it.

Further Reading