> ## Documentation Index
> Fetch the complete documentation index at: https://docs.partnero.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create product-based commissions

> Pay a different commission for specific products, product types or prices

Product commissions pay a different rate when a sale includes a specific product, product type or price. Use them to
push high-priority products or to protect margins on low-margin ones. For example:

* 40% on your annual plan and the default 20% on everything else.
* A fixed \$50 for every hardware sale.
* 30% on several plans at once, by listing their price IDs in one rule.

A product rate replaces the default commission on matching sales; it isn't added on top.

***

## Add a product commission

1. Open your affiliate program, go to **Settings** under **Program**, scroll to **Commission** and click
   **Set up rules** (or **Manage rules**).
2. Open the **Product commissions** tab and click **Add**.
3. Fill in the rule. It reads as a sentence: *\[amount] \[% or currency] when \[product id, product type or price id]
   \[values]*, for example *40 % when product id prod\_annual*. The parts are explained [below](#parts-of-a-rule).
4. Click **Save** to close the window, then **Update** to save the program settings.

You can add up to 5 product rules.

***

## Parts of a rule

### Amount and type

Each rule has its own type, whatever type your default commission uses. Click **%** for a percentage of the sale or
the currency button (for example **USD**) for a fixed amount.

### Match by

| Option | Matches when the sale's | Example |
| - | - | - |
| **product id** | Product ID is one of the values | `prod_NjK9`, a Stripe product ID |
| **product type** | Product type or category is one of the values | `annual`, `hardware` |
| **price id** | Price ID is one of the values | `price_1PqR`, a Stripe price ID |

### Values

Type a value and press Enter. Add several values to give a group of products the same rate.

On a **product id** rule, if Stripe, Shopify, Paddle or Chargebee is connected, click the import button next to the
rule to pick products from your store instead of typing their IDs.

***

## When product and dynamic rules both match

If a sale matches a product rule and a [dynamic commission](https://docs.partnero.com/knowledge-base/commissions-rewards/create-dynamic-commissions.md),
the dynamic commission is used by default. To use the product rate instead, turn on **Prioritize product commission**
at the bottom of the **Product commissions** tab.

### Sales with several products

With **Prioritize product commission** on, a sale that includes several products — such as a Shopify order or a
Stripe invoice with several items — is split by product. Each product earns its own product rule's rate on its own
price, and the results are added up. With the setting off, the whole sale earns one rate.

> [!WARNING]
>
> In this mode, products in the sale that don't match any product rule don't earn commission, and a partner's
> custom commission isn't applied. Add a product rule for every product partners should earn on.

***

## Examples

All examples use a default commission of 20%.

| Goal | How to set it up | Result |
| - | - | - |
| A higher rate on the annual plan | *40 % when product id prod\_annual* | A $300 annual sale earns $120. A $30 monthly sale earns the default $6 |
| A fixed amount for a product category | *50 USD when product type hardware* | Every hardware sale earns \$50, whatever its price |
| One rate for several plans | *30 % when price id price\_pro\_monthly, price\_pro\_yearly* | Sales of either price earn 30% |
| The product rate even for top partners | *40 % when product id prod\_annual*, a dynamic rule *25% if customers more than 20*, and **Prioritize product commission** on | A partner with 25 customers earns 40% on the annual plan. With the setting off, they'd earn 25% |
| Pay on each product in an order | **Prioritize product commission** on, with *40 % when product id prod\_annual* only | An order with the $300 annual plan and a $50 add-on earns \$120. The add-on has no rule, so it earns nothing |

***

## Good to know

* If a sale matches several product rules, the one with the highest commission is used.
* A partner's [custom commission](https://docs.partnero.com/knowledge-base/commissions-rewards/custom-commission-for-individual-partners.md)
  overrides product rules, except for sales split by product (see the warning above).
* Sales without product data earn the default or dynamic commission.
* [Discount-based adjustments](https://docs.partnero.com/knowledge-base/commissions-rewards/adjust-affiliate-commission-when-a-discount-code-is-used.md)
  and the [maximum commission](https://docs.partnero.com/knowledge-base/commissions-rewards/guide-to-commission-set-up.md#adjust-commission-options)
  still apply to product commissions.
* See [How commission rules work together](https://docs.partnero.com/knowledge-base/commissions-rewards/advanced-commissions-explained.md) for
  the full order.

***

## Send product data to Partnero

Product rules only work if Partnero knows which product was sold.

* **Stripe, Shopify, Paddle and Chargebee** — product data is sent automatically.
* **API** — add `product_id`, `product_type` or `price_id` to the transaction. See
  [Create a transaction](https://docs.partnero.com/api-reference/transactions/create.md).
* **Other integrations** — check that the product ID or type is passed with each transaction.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.