Cross-sells enable customers to optionally purchase other related products using Checkout. Cross-sells can increase your average order value and revenue.
For Checkout to offer a product as a cross-sell, the product must meet the following criteria:
- The product must be associated with only a single Price.
- The currency of the cross-sell product’s price must match the currency of the other prices in the Checkout Session.
- If the cross-sell product’s price type is
recurring, the Checkout Session must be in subscription mode and its recurring interval must match the recurring interval of the other prices in the Checkout Session.
- If you’re using subscription upsells, cross-sells only support products with non-recurring prices. For example, you can cross-sell a one-time setup fee while also upselling a monthly subscription to annual billing.
Create a cross-sell
You can configure a cross-sell in the Dashboard on the Product details page. Visit the Product details page for the product from which you want to cross-sell another complementary product. You’ll see a Cross-sells section with a dropdown menu containing your other Products. Select a Product with a single Price. After you configure it, all eligible Checkout Sessions cross-sell the product selected from the dropdown menu. For example, a customer purchasing a ‘Togethere Professional’ subscription would be cross-sold the ‘Professional Services: Deployment’ product.
In Checkout, buyers see an option to add the cross-sell to their purchase. If buyers add the cross-sell to the Checkout Session, they can also remove it. If they remove it, the option to add the cross-sell appears again.
The quantity of cross-sell line items cannot be adjusted. The current maximum is 1.
Retrieve Checkout Session line items
After a customer adds a cross-sell, the
line_items for the Checkout Session update to reflect the addition. When fulfilling your order using the
checkout.session.completed webhook, make sure to retrieve the line items.
Remove a cross-sell
To remove a cross-sell, click the x next to it. After you remove it, the product won’t be offered to any new Checkout Sessions.