Alternate Product Substitution

In conjunction with Best Practice Design, CSS offers an Alternate Product Substitution feature, whereby out of stock items in the cart can be substituted at the user's request. This feature could also be used to showcase higher quality or higher margin products compared to those your customer has selected. 

The scenario is as follows:

  1. A product in the cart is out of stock. A 'Show Alternates' prompt appears under the product detail.
  2. On clicking 'Show Alternates', a modal window opens.
  3. Alternate products are presented in grid format.
  4. User selects an alternative option via the 'Substitute' button.
  5. The out of stock product is removed and the alternate is added to cart in its place. 

Note: This functionality is available in CSS versions 3.79 and later.


Step-by-step guide

To configure Alternate Product Substitution functionality:

  1. Login to the CMS.
  2. Navigate to Layouts --> Templates
  3. Click the 'Cart' template.
  4. Scroll to 'Zone Main' and click 'Add Widget'
  5. Select 'Alternates Popup' and click 'Add'.
  6. Click 'Edit' and configure options:

    • Description - A description for the Administrator's reference. Appears on this widget layout page only.
    • Layer - Select a layer to display this conditionally (e.g. for B2C roles only), or leave as 'All Pages' by default.
    • Always Display 'Show Alternates' Button? - Tick this if you'd like the prompt to show for ALL products in the cart which have alternates set up against them, whether in stock or not. Otherwise, the prompt will only show for Out Of Stock products. 
    • Popup Window Header Text - The title which displays on the modal window for alternate products.
  7. Click 'Save'
  8. Navigate to Layouts --> Templates.
  9. Click the 'Order Lines Info' template.
  10. Click 'Add Widget'.
  11. Select the 'Alternates Order Line' widget and click 'Add'.
  12. Click 'Edit' and configure options:
    • Description - A description for the Administrator's reference. Appears on this widget layout page only.
    • Layer - Set this to match the Layer setting for the 'Alternates Popup' widget configured previously.
    • Show Alternates Button Text - The text which appears on the button prompt in the cart.
  13. Click 'Save'.

The 'Show Alternates' button will now appear in the cart based on the options set above. The button sits just under the product information and is styled in line with the site theme. 


To customise the appearance of product data on the Alternates Popup: 

  1. Navigate to Layouts --> Templates.
  2. Click the 'Alternates Popup' template.
  3. Here, the product list widgets are laid out in the order they appear (eg. product image at the top, then product title (description), product code, etc). 
  4. Select the required widget and click 'Edit' to configure options, or 'Delete' to remove it. Depending on the site version, the option to disable (rather than remove) a widget may also be present.
  5. New widgets can also be added to this template if product data you wish to show is missing. 
  6. Changes will be visible on refresh of the web page. 


Please Note - Products must have Alternates configured (either in the ERP or the CMS) in order for this functionality to work. If an out of stock product has no Alternate data, the button will not display. 

Information on configuring Alternate product data in PRONTO can be found here




Have more questions? Submit a request


Powered by Zendesk