Manage Static Product Recommendations

These settings are only available via the Legacy Bolt Merchant Dashboard. All Bolt features and settings will be included in the new Merchant Dashboard at a later date.

Static Product Add-ons & Upsells enable merchants to suggest specific items to their shoppers either during checkout or when they view an order tracking page. This can be set up through the Bolt Merchant Dashboard.

How to Manage Static Product Add-ons

Merchants must reach out to their Customer Success Manager to have this feature enabled in the dashboard before using the following steps.

For Standard Implementations

The following steps are for merchants using a dedicated plugin integration. For custom integrations, see the next section.

Add a Product

1. Log in to the Bolt Merchant Dashboard.

2. Navigate to the Settings > Checkout.

3. Scroll to Product Add-ons in Checkout.

4. Select + NEW ADD-ON.

5. Complete the following fields:

   • Name: Displayed to shoppers; recommended <20 characters.
   • Description: Displayed to shoppers.
   • Product ID: Defines the shopping cart platform identifier used when adding the item to the shopper’s cart. Note that the Product ID is a separate identifier than the product SKU.
   • Unit Price (USD): Defines the cost of the product. This amount should match the shopping cart platform price. If you find a variance please contact Bolt Support.
   • Image URL: Displays the image to the shopper.
   • Product URL: Defines the displayed link for the add-on product’s dedicated page.
   • Display in Checkout: Displays the product add-on in the Bolt Checkout modal.
   • Display in Tracking: Displays the product add-on post-purchase. This should only be checked if using Bolt’s Order Tracking feature.
   • Always Display: Displays the product add-on even when the item is currently in the cart.
   • Show info Modal: Should only be enabled when using Bolt’s BigCommerce and Route integration.

6. Select ADD PRODUCT ADD-ONs.

   

You can edit the product at any time.

Remove a Product

1. Log in to the Bolt Merchant Dashboard.
2. Navigate to the Settings > Checkout.
3. Scroll to Product Add-ons in Checkout.
4. Find the product’s row.
5. Select Delete.
6. Select REMOVE ADD-ON to confirm.

For Direct (Custom) Implementations

To associate add-ons with a cart, simply add the add_ons array to your Order Creation POST request to /v1/merchant/orders and include the add-on product’s details.

Example Add-On

    ...
    "add_ons": [
      {
        "name": "Magical Paper Weight",
        "description": "It changes colors on your desk!",
        "productId": "MPW-002",
        "imageUrl": "https://mystore.com/products/mpq-002/img.png",
        "productPageUrl": "https://mystore.com/products/categories/magical-paper-weight",
        "price": 300
      }
    ],
    ...

Example Cart Structure

"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": "Magical Paper Weight",
	  "description": "It changes colors on your desk!",
	  "productId": "MPW-002",
	  "imageUrl": "https://mystore.com/products/mpq-002/img.png",
     "productPageUrl": "https://mystore.com/products/categories/magical-paper-weight",
  	  "price": 300
        },
       {
 	  "name": "Add On 2",
	  "description": "Compliments Item 3",
	  "productId": "product_2",
	  "imageUrl": "https://picsum.photos/88/88",
     "productPageUrl": "https://bolt.com",
  	  "price": 249
	}
  ]
}