📍 Bolt Help / Dashboard / Checkout Settings / Add-Ons / API Product Add-ons
API Product Add-ons
This feature displays a programmatic sets of product recommendations to shoppers during checkout or order tracking.



API Product Add-ons (Conditional) is in Beta release phase and currently available to participating merchants.

API Product Add-ons are a powerful driver of Average Order Value (AOV) and enable merchants to make personalized recommendations to their shoppers based on what is currently in their cart, shopping history, and browsing history.

API Product Add-ons is a powerful way to offer meaningful and relevant upsells to your customers. Dynamic Recommendations can only display products that do not have variants (i.e., size or color options).

Merchants can use their own upsell engine (built in house or a third-party service) to power product upsells in checkout. To do so, merchants need only pass in the recommendations they would like to show a given shopper into our checkout modal, and Bolt does the rest.


Platform Supported Products

Custom Cart / Direct API

Salesforce Commerce Cloud SFRA

  • Supported for Bolt Managed Checkout.
    • Bolt allows checkout integrations for site built with SFRA (Salesforce Resource Architecture).

    • Supported for both Bolt’s SFRA v1.0 and v2.0 plugins.

  • Supported for Bolt Embedded Accounts.

    • Bolt allows embedded accounts integrations for site built with SFRA (Salesforce Resource Architecture).

    • Supported for both Bolt’s SFRA v1.0 and v2.0 plugins.

Set Up


You can only display Dynamic Recommendations on the post-checkout confirmation page.

You can create recommendations based on certain customer order criteria. For example, if a customer adds a certain product to their order, you can recommend accessories or other items that compliment their purchase.

Follow the Product Recommendations guide to get started.

Product Add-ons

Before You Start

Product Add-ons require that you have the Enable cart based dynamic add-ons flag turned on for your merchant division. Reach out to your Bolt Integration Engineer or Customer Success Manager to enable this feature.

Additionally, you must specify the Update Cart URL for your merchant division. This can be communicated to your Bolt Integration Engineer or Customer Success Manager, as well. You must then implement the Update Cart URL in your code to allow the Add-Ons to be added to your cart using the cart.update endpoint in our Merchant Callback API.

If you already have other add-ons enabled, as listed in our in our Product Add-Ons and Upsells documentation, then no changes need to be made to this endpoint.

Order Creation

To associate Add-Ons with the current cart, you must include the Add-Ons in the Cart JSON during order creation, as seen in the Order Creation endpoint.

Example of a Cart JSON that includes add_ons:

"cart": {
  "id": "4032665549291181",
  "displayId": "5913529137882847",
  "items": [
      "reference": "3",
      "image": "https://placeimg.com/30/30/animals/grayscale",
      "name": "Item3",
      "price": "$8.94",
      "desc": "Item3, the new gold standard for items",
      "sku": "SK-3",
      "quantity": 1
  "currency": "USD",
  "add_ons": [
 	 "name": "Add On 1",
	  "description": "An important add on",
	  "productId": "product_1",
	  "imageUrl": "https://picsum.photos/88/88",
        "productPageUrl": "https://bolt.com",
  	  "price": 199
 	  "name": "Add On 2",
	  "description": "Compliments Item 3",
	  "productId": "product_2",
	  "imageUrl": "https://picsum.photos/88/88",
        "productPageUrl": "https://bolt.com",
  	  "price": 249

That’s it! Nothing else needs to be done for your Add-Ons to appear in the checkout modal.

Product Add-ons

Filter by Section
Filter by Topic