Configure product offers

Learn how to create and manage product offers.

Recommend complementary or higher-value items at checkout. Follow this guide to configure cross-sell and upsell offers, customize their display text, and choose placement, so shoppers see the most relevant suggestions.

Quick start

To get started, follow these steps:

  1. Sign in to the FastSpring app.
  2. Go to Catalog > choose Subscription Plans, One-Time Products, or Bundles.
  3. From that list, select the item you want to add offers to. The details page opens, showing the Related Offers section.

Next, scroll down to the Create a cross-sell offer or Create an upsell offer section to set up your offer.

Create a cross-sell offer

Use cross-sell recommendations to suggest complementary products when a customer adds an item to their cart.

  1. On the details page, open the Related Offers section and click Add > Product Offer.
  2. Select Cross-sell as the Offer Type.
  3. (Optional) In Display, enter a customer-facing message.

    Use the language dropdown to add translations.

  4. Choose a Placement number from the dropdown to control the order in which offers appear at checkout.

    This only applies if you configure two or more options for the product.

  5. In the Products field, start typing the name of the product you want to offer.

    Tip: To offer a special price on the cross-sell, first create a private product variation for that item, then select it here.

  6. (Optional) Select Preselected to auto-add the cross-sell to the cart.
  7. Click Save.

Once saved, the cross-sell will appear on your web checkout each time a customer selects the associated product.

Best practices for cross-sells
  • Public Only: Only cross-sell products that are already public in your store.
  • Price Logic: Keep cross-sells under 50% of the driving product's price.
  • Don't Overwhelm: Limit the number of cross-sells to avoid decision paralysis.

Create an upsell offer

Use upsells to encourage customers to choose a higher-value product at checkout.

  1. On the details page, open the Related Offers section and click Add > Product Offer.
  2. Select Upsell as the Offer Type.
  3. (Optional) Enter a Display message.
  4. Choose a Placement number from the dropdown to control the order in which offers appear at checkout.

    This only applies if you configure two or more options for the product.

  5. In Products, select the upsell product.
  6. Click Save.

Once saved, the upsell will appear on your web checkout each time a customer selects the associated product.

Best practices for upsells
  • Value Add: Choose upsells with clear added value (features, support, etc.).
  • Price Logic: Avoid upsells that increase the order total by more than 25%.
  • Limit Options: Limit to 1–2 upsell options per product.

Edit placement of offers

Control where cross-sells and upsells appear on your checkout:

  1. Go to Checkouts > Web Checkouts.
  2. Select your checkout and click Settings.
  3. In the left menu, choose Promotions.
  4. Under Product Page, adjust the position for Related Offers.

Product offers API overview

While the FastSpring app supports standard Cross-sells and Upsells, the Product Offers API allows you to programmatically configure advanced offer logic, such as downgrades and subscription modifications.

Supported API offer types

Offer TypeContextDescription
UpsellInitial PurchaseEncourage higher-value choices (e.g., Gold vs Silver).
Cross-sellInitial PurchaseRecommend complementary items (e.g., Support package).
Down-sellInitial PurchaseOffer budget-friendly alternatives if the user hesitates.
UpgradeSubscriptionMove an existing subscription to a higher tier.
DowngradeSubscriptionMove an existing subscription to a lower tier.
Cross-gradeSubscriptionMove a subscription to a different but related product line.
Add-onSubscriptionAdd a secondary product to an existing subscription.
AlternativeSubstitutionDisplay eligible substitutes for the current item.

Endpoints at a glance

MethodEndpointAction
GET/products/offers/{product_path}Retrieve product offers
POST/products/offers/{product_path}Create or update product offers

Explore the full product offers API reference for payload examples, schemas, and additional endpoints.