Product Upsells & Add-ons: Setting Up Add-on Product Activities
With the Add-on products feature in the Product Upsell & Add-ons app, you can recommend relevant products on product detail pages or in the shopping cart and offer exclusive discounts to encourage customers to purchase additional items alongside their main products, increasing your average order value.
You can select specific products or use AI-powered recommendations based on your promotional needs, then configure add-on prices, discounts, and purchase quantity limits. You can also customize how add-on products are displayed to align with your store's sales strategy.
This guide explains how to create, manage, and edit add-on product promotions for product detail pages and the shopping cart, as well as how to check which promotions a product is currently included in.
| Note: If you’re using a SHOPLINE OS 3.0 theme, the Add-on products feature in the Product Upsells & Add-ons app must be manually added as an app block in the theme editor to display properly. For details on app block functions, setup steps, and which app features require app block support, refer to the Help Center article "Integrating Apps into OS 3.0 Themes." |
Notes for Creating Add-on Product Activities
Before creating add-on products, please consider the following:
- Quantity of Add-On Products: You can select up to 10 add-on items for each main product on the product detail pages. In the shopping cart, a maximum of 10 add-on items can be selected.
- Main Add-On Product: In add-on activities, you can designate both a manually selected add-on item and an AI-recommended add-on item for the same main product.
- Add-on Product Pricing: When you choose an add-on product, its price is set as the selling price by default. You can manually adjust the price, but it should not exceed the selling price of the product. If the product has multiple variants, the price of the add-on product should not exceed the lowest selling price. When you select Recommend certain products for a product page add-on promotion, you can also enable No discount for individual add-on products. These products will be sold at their current selling prices, which automatically update when the selling prices change.
- Limit on the Purchase Quantity of Add-on Products: You can set a limit on the number of add-on products that can be purchased with each main product (variant). If no limit is set, customers can add any quantity of add-on products when purchasing the main product. When you select Recommend certain products for a product page add-on promotion, you can alternatively set a separate purchase quantity limit for each add-on product. You can only use one of these two methods at a time.
- Add-on Product Activities: Add-on products featured in an activity are only available for purchase within that activity. Customers can purchase these add-on products at the specified add-on price set by you. However, add-on products cannot be combined with any other promotional offers and can only be purchased at the set add-on price. This restriction also applies to add-on products with No discount enabled, even though they are sold at their regular selling prices.
- Pricing for Setting Up Shopping Cart Add-on Products: The Shopping cart add-on products feature is available for a fee of USD 9.99 per month. After payment, you can set up and activate corresponding add-on product activities during the valid period. Once expired, the corresponding promotions will become invalid.
- Impact of Add-On Product Changes: If the add-on products you have set are deleted, deactivated, or out of stock, the corresponding add-on product variants won’t be displayed in your store, and customers won’t see these add-on products.
Creating Add-on Product Promotions for Product Pages
Navigation
- From your SHOPLINE Admin, go to Apps > Product Upsell & Add-ons.
- Click the Add-on products tab.
-
In the Add-on products for product page card, click Create add-on products or Manage add-on products.
- Click Create.
Steps
- In the Activity title section, enter a name for the add-on product promotion. This name will appear as the title above the add-on products section on the shopping cart and checkout pages.
- In the Main product section, select which products the promotion applies to:
- All products: Apply the promotion to all products in your store.
- Specific product category: Click Select a category and select the applicable product categories. The promotion will automatically apply to products in the selected categories.
- Specific product: Click Select product(s) and manually select up to 500 products.
- In the Add-on products section, select a recommendation method and configure the corresponding settings:
-
AI algorithm recommendation: Use SHOPLINE's recommendation algorithm to suggest add-on products based on the main product.
- Recommended products: Drag the slider to set the number of add-on products to recommend, from 1 to 10.
- Set the maximum purchase quantity for add-on items: Check this option and enter the maximum total quantity of add-on products customers can purchase for each unit of the main product.
-
-
Recommend certain products: Click Select a product to manually select the add-on products you want to recommend, then configure their prices and purchase quantity limits.
- Add-on product price: Set the add-on price for each product. If a product has multiple variants, click the Edit (pencil) icon to configure prices for individual variants.
- No discount: Enable this option to sell the add-on product at its current selling price. You won't be able to manually adjust its add-on price or configure separate prices for individual variants. The strikethrough price will also be hidden in your store.
- Set maximum purchase quantity for add-on items: Enable this option and enter a limit in the Maximum purchase quantity field for each add-on product. This determines how many units of each add-on product customers can purchase per unit of the main product, up to 999.
- Set the maximum purchase quantity for add-on items: Check this option and enter a limit on the total quantity of add-on products customers can purchase per unit of the main product.
Note:
- Manually configured add-on product prices must be greater than 0 and lower than the product's selling price.
- You cannot enable both the individual add-on product quantity limit and the overall add-on product quantity limit at the same time.
- If no purchase quantity limit is set, customers can purchase any quantity of add-on products.
-
In the Add-on items settings section, configure how add-on products are displayed and which discounts apply.
-
Display mode: Select one of the following options to determine when customers see the add-on products in your store:
- Display on product details page: Display add-on products directly on the product detail page.
- A pop-up window displays when clicking Add to Cart: Display add-on products in a pop-up window when customers click the Add to Cart button on the product detail page.
- A pop-up window displays when clicking Checkout: Display add-on products in a pop-up window when customers click the Checkout button on the product detail page.
-
Discount plan (only available for AI algorithm recommendation): Select the discount type for add-on products:
- No discount: Offer add-on products without additional discounts.
- Fixed amount discount: Apply a fixed-amount discount to add-on products.
- Percentage discount: Apply a percentage discount to add-on products.
- Product details page display title: Enter the title displayed above the add-on products on the product detail page, such as "You May Also Like" or "Add More Items to Save."
Note: If you're using an OS 3.0 Theme, you must manually add the Add-on Product app block in the theme editor to display add-on products correctly on product detail pages. You can also adjust the block's position in the theme editor. For details, refer to "Integrating Apps into OS 3.0 Themes." -
Display mode: Select one of the following options to determine when customers see the add-on products in your store:
- Review your settings and click Create to create the add-on product promotion.
The promotion is Enabled by default. You can change its status using the toggle in the upper-right corner of the page.
Understanding Add-on Product Purchase Quantity Limits
If you enable Set maximum purchase quantity for add-on items to configure individual quantity limits, the following rules apply:
- Maximum purchase quantity: The maximum quantity of each add-on product equals the quantity of the main product purchased multiplied by the add-on product's Maximum purchase quantity setting. For example, if add-on product A has a limit of 1, a customer purchasing 2 units of the main product can add up to 2 units of product A.
- Changes to main product quantity: If a customer reduces the quantity of the main product and the selected add-on quantity exceeds the new limit, the system will deselect the excess add-on items.
- Product detail page: The purchase quantity limit for each add-on product is displayed on the product detail page. Customers cannot increase the quantity beyond the limit.
- Shopping cart and checkout: If the quantity of an add-on product exceeds the limit in the shopping cart or at checkout, the excess quantity will no longer qualify for the add-on discount.
Managing Your Add-on Product Activities
After creating your add-on product activities, you can manage and access the editing page of any specific add-on product activity through the list of add-on product activities.
- From your SHOPLINE admin panel, go to Apps > Product Upsells & Add-ons.
-
On the Product Upsells & Add-ons homepage, click Add-on products > Manage add-on products to view all the add-on product activities you have created.
- Activity title: View the names of the created add-on activities.
- Add-on products: See the image and quantity of the add-on product for each activity.
- Total sales ($): Check the current total sales for each add-on product activity. This includes sales from orders containing any add-on product.
-
Status: View the status of each activity.
- Enabled: The add-on product activity is active, and customers can see it on the product details page of the corresponding main product.
- Disabled: The add-on product activity is inactive, and customers will not see it in the store.
- Action: Click the Preview eye icon to preview the add-on product activity on the product details page of the corresponding main product.
- Bulk operations: You can bulk disable or delete add-on product activities. Select the activities you want to operate on, then click Disable or Delete and confirm in the pop-up window. The selected activities will be disabled or removed in bulk.
Edit Add-on Product Activities for Product Pages
You can edit the details of your add-on product activity from the settings page, including the activity title, main product, add-on product(s), add-on product price(s), No discount settings, and purchase limit.
- From your SHOPLINE admin panel, go to Apps > Product Upsells & Add-ons.
- In the app, click Add-on products > Manage add-on products.
- Search or select the activity you want to edit, then click on it to access the editing page.
-
Make your modifications and click Update. Your store will display the latest activity information.
Notes:
- Updates to activities won't affect previously placed orders.
- Prices of add-on products already in the shopping cart won't change due to edits made here. These products will be charged at their original price unless removed from the activity.
- You can also disable any add-on product activity as needed. Simply toggle off the Enabled switch on the specific activity settings page. Once disabled, the activity will no longer appear in your store, and its status will change to Disabled.
Creating Add-on Product Activities for Shopping Carts
Here's how to set up add-on product activities specifically for shopping carts:
- From your SHOPLINE admin panel, go to Apps > Product Upsells & Add-ons.
- In the app, go to Add-on products > Shopping cart add-on products and click Set an add-on product.
-
Configure the following settings:
- In the Activity title section, enter the name of the add-on product activity.
- In the Trigger section, choose the main product for this add-on product activity. You can select from all products in your store, specific product categories, or specific products.
- In the Recommendation methods section, choose between:
- AI recommendations: SHOPLINE’s AI algorithms automatically calculate and recommend up to 10 add-on products.
- Recommend specific products: Choose from your store’s product pool. Each activity allows a maximum selection of 10 add-on products.
- In the Add-on products configuration section, choose the Display method of the add-on activity and select from the following discount options:
- No discount: Each add-on product is displayed at its original price.
- Percentage discount: Apply a specified percentage discount to each add-on product, up to a maximum discount of USD 0.
- Fixed amount discount: Apply a specified amount reduction to each add-on product, up to a maximum discount of USD 0.
- In the Color settings section, customize the background color, text color, and border color for the title.
-
Once you've created an activity, enable the switch to display it on the main product's shopping cart page.
| Note: For a seamless shopping cart experience, the colors of product names, prices, and other elements in add-on products will automatically match your store's theme. |