Cross-sells

Enable customers to purchase complementary products at checkout by using cross-sells.

A cross-sell is a product that you can add to an order using Checkout.

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 have exactly one active Price that doesn’t use metered billing or a custom amount. Archived Price objects don’t affect eligibility.
• 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.
• If you’re using automatic taxes , cross-sells only support products with prices with specified tax behavior . You can either set tax behavior for a price or set the default tax behavior for all prices under Tax Settings in the Stripe Dashboard.
• If you’re using Managed Payments , cross-sells only support products that are eligible for Managed Payments .

Create a cross-sell

Configure a cross-sell on the Product details page.

You can configure a cross-sell in the Dashboard. Go to the details page for the product that you want to use to cross-sell another product. In the Cross-sells section, use the Cross-sells to field to choose a product with exactly one active eligible Price. After you configure it, Checkout offers the selected product in all eligible Checkout Sessions. For example, you might cross-sell the ‘Professional Services: Deployment’ product to a customer purchasing the ‘Professional’ tier product.

Checkout flow

In Checkout, customers see an option to add the cross-sell to their purchase. If customers 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.

Note

The quantity of cross-sell line items can’t be adjusted. The current maximum is 1.

Customer preview.

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

You can remove a cross-sell on the Product details page. After you remove it, the product won’t be offered to any new Checkout Sessions.

Remove a cross-sell.