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:
- Sign in to the FastSpring app.
- Go to Catalog > choose Subscription Plans, One-Time Products, or Bundles.
- 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.
- On the details page, open the Related Offers section and click Add > Product Offer.
- Select Cross-sell as the Offer Type.
- (Optional) In Display, enter a customer-facing message.
Use the language dropdown to add translations.
- 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.
- 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.
- (Optional) Select Preselected to auto-add the cross-sell to the cart.
- 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.
- On the details page, open the Related Offers section and click Add > Product Offer.
- Select Upsell as the Offer Type.
- (Optional) Enter a Display message.
- 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.
- In Products, select the upsell product.
- 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:
- Go to Checkouts > Web Checkouts.
- Select your checkout and click Settings.
- In the left menu, choose Promotions.
- 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 Type | Context | Description |
|---|---|---|
| Upsell | Initial Purchase | Encourage higher-value choices (e.g., Gold vs Silver). |
| Cross-sell | Initial Purchase | Recommend complementary items (e.g., Support package). |
| Down-sell | Initial Purchase | Offer budget-friendly alternatives if the user hesitates. |
| Upgrade | Subscription | Move an existing subscription to a higher tier. |
| Downgrade | Subscription | Move an existing subscription to a lower tier. |
| Cross-grade | Subscription | Move a subscription to a different but related product line. |
| Add-on | Subscription | Add a secondary product to an existing subscription. |
| Alternative | Substitution | Display eligible substitutes for the current item. |
Endpoints at a glance
| Method | Endpoint | Action |
|---|---|---|
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.
Updated 10 days ago
