Sign in
An image of the Stripe logo
Create account
Sign in
Home
Payments
Business operations
Financial services
Developer tools
No-code
All products
Home
Payments
Business operations
Home
Payments
Business operations
Financial services
Developer tools
Support
Overview
Online payments
Products and prices
Invoicing
Subscriptions
Quotes
In-person payments
Multiparty payments
After the payment
Add payment methods
Payment Links
Stripe Checkout
    Overview
    How Checkout works
    Quickstart
    Fulfill your orders
    Migrate payment methods to the Dashboard
    Migrate from legacy Checkout
    Migrate Checkout to use Prices
    Customize your integration
    Customize branding
    Collect taxes
    Collect tax IDs
    Collect phone numbers
    Post-payment invoices
    Make line item quantities adjustable
    Add custom fields
    Let customers decide what to pay
    Boost revenue
    Present local currencies
    Configure subscription upsells
    Configure cross-sells
    Recover abandoned carts
    Collect consent for promotional emails
    Analyze conversion funnel
    Additional features
    Add discounts
    Add shipping
    Start a free trial without collecting payment details
    Manage limited inventory
    Guest customers
Stripe Elements
About the APIs
Regulation support
Implementation guides
Testing
Checkout
·
HomePayments

Cross-sells

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

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 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

Configure a cross-sell on the Product detail page.

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.

Checkout experience

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.

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

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.

Remove a cross-sell.

Was this page helpful?
Questions? Contact us.
Watch our developer tutorials.
Check out our product changelog.
Powered by Markdoc
You can unsubscribe at any time. Read our privacy policy.
On this page
Cross-sells
Create a cross-sell
Checkout experience
Retrieve Checkout Session line items
Remove a cross-sell
Stripe Shell
Test mode
Welcome to the Stripe Shell! Stripe Shell is a browser-based shell with the Stripe CLI pre-installed. Login to your Stripe account and press Control + Backtick on your keyboard to start managing your Stripe resources in test mode. - View supported Stripe commands: - Find webhook events: - Listen for webhook events: - Call Stripe APIs: stripe [api resource] [operation] (e.g. )
The Stripe Shell is best experienced on desktop.
$