Adobe will stop hosting existing sites on Business Catalyst on June 18th, 2019. Adobe encourages customers to download their data and migrate to other systems well before June 18th, 2019. For detailed how-to information and assistance, see the Business Catalyst FAQ.

Add size and weight dimensions to products

  1. Open the product settings by selecting E-Commerce > Products and clicking the product from the list.
  2. Expand the Product Dimensions section.
  3. Enter the product dimensions, and then click Save.

    For details, see tool tips next to the options.

Create a custom shipping option

  1. Select E-Commerce > Shipping Options.
  2. Ensure User Defined is selected from the Type menu, and then click Show More Options.
  3. Specify the shipping option properties. 

    For details, see tool tips next to the options.

  4. Click Save.

    To add more shipping options, click Add New Shipping Option

Create a free shipping option

  1. Select E-Commerce > Shipping Options.
  2. From the Type menu, select Free Shipping.
  3. Select one of the following:
    • Amount - Select this option to display free shipping if the total of an order is above the specified amount. Example: Free shipping for orders over $100.
    • Quantity - Select this option to display free shipping if the number of items added to the cart is above the specified amount.
  4. Enter the value criteria, and then click Save.


When adding the system generated free shipping option, this will be the only shipping option available and will remove all other shipping options from the shopping cart.

Example: If you have one product that falls under the free shipping requirements and another product that falls under a different shipping category, then when both these products are added to the cart, only the Free Shipping option will be available.

If you did not want this type of functionality, then what you will need to do is create your own user-defined free shipping option by setting the price to $0 and setting the necessary requirements to apply this option.

Add shipping options to the shopping cart

  1. Select Site Manager > Module Templates, and then click Online Shop Layouts.
  2. Select Shopping Cart from the list.
  3. Place the cursor in the content editor where you want the shipping options to display, and  then select {tag_shippingoptions} from the Tag Insert menu. 

    For a list of available options for this tag, see Tags - Quick Reference

  4. Click Save.


The default shopping cart layout includes the {tag_shippingoptions} tag. To avoid duplicate shipping options, ensure that you remove the existing tag before adding another tag.

Validate shipping selections

If all purchases on your site include shipping charges, you can optionally add a server-side validation feature. This feature checks to make sure that every order has a valid shipping charge before the customer can pay and finalize the order.

  1. Select Site Manager > Module Templates, and then click Online Shop Layouts.  
  2. Select Shopping Cart from the list.
  3. Locate the {tag_buybutton} in the content editor and modify the tag as below:

    {tag_buybutton,Text or Image,true}

    Replace "Text or Image" with the text to display for the button, or with the path to an image to be used as the button.

Add a third-party shipping provider

  1. Select E-Commerce > Shipping Options.
  2. From the Type menu, select the relevant third-party shipping provider.
  3. Enter the distribution zip/post code, and select the shipping service. 

    To provide multiple services for the one provider, add a shipping option for each service.

  4. Specify any additional criteria for the shipping option, and then click Save.

Customizing the shipping options tag

You can customize the way shipping options are displayed within the shopping cart by modifying the tag in the layout.

  1. Select Site Manager > Module Templates, and then click Online Shop Layouts.
  2. Select Shopping Cart from the list.
  3. Locate the {tag_shippingoptions} tag in the layout, and then customize this tag by adding one or more of the below options:

See below for details on each option:

true - This parameter enables Delivery Country and Delivery State dropdown. You need to use this parameter if you want to display the state tax or provincial tax for certain countries. 

Only Charge Country Users - True by default. For example if your customers are in the US, then they are forced to choose the state that they want the goods to ship to and will need to pay the relevant taxes. However if the purchasing customer is in Australia and are shipping the goods to United States California, then they are not forced to pay state taxes.

Ship to Single Country - If you only ship to a single country, then enter the 2-letter country code for that country, e.g. US for United States, otherwise leave empty. If you leave out this option the system will allow shipping to any country.

Note that you can actually select to ship the goods to multiple countries by entering the two letter codes for those countries and separating them by semi-colon (;) e.g. US;AU;GB

Apply Tax to Shipping Charges - True by default. If you don't want state taxes to be applied to shipping charges, then set this to false.

Apply Tax to Gift Vouchers - True by default. If the cart contains both, products and gift voucher items, then state tax is applied to all of them. By setting this value to false you will exclude state tax from being applied to gift vouchers. In the scenario where gift vouchers are excluded from state tax, the original tax rate for the gift voucher will remain applicable.


  • Display all countries in the Delivery Country menu and all tax codes in Delivery State menu
  • Not adding state tax to shipping charges and gift vouchers:
  • Limiting delivery to US and GB only (Delivery Country dropdown will have US and GB only on it)

Related topics

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy