Product Bundles

From WHMCS Documentation

Product Bundles are a very powerful tool in WHMCS. They can allow you to set up order form links that will automatically take the user through the process of adding two or more products in a single ordering process. They will also provide a way to link to the order form from the pages of your site, with specific preselected configurations, by default.

You can access this feature at Configuration () > System Settings > Product Bundles.

What a Product Bundle Can Do

Product bundles allow you to:

  • Generate shortcut links to add a product to the cart with preconfigured selections and values.
  • Generate order links that involve adding more than one product to the cart.
  • Create incentives in which, if they buy two or more items with specific configurations, the user receives a discount.

Some Examples

For example, you could create some of these offers using bundles:

  • Buy Hosting for a Year along with a Domain and Save $x
  • Buy Hosting and an SSL Certificate, and get a Domain Free
  • Buy Annual Hosting + Product X and Save $20
  • Buy Product X, Y & Z together and save 25%
  • Buy Product X on Billing Cycle Y, and get 50% off Product Z
  • Buy Product X with 2 domains and get the second domain free

Bundle Requirements

One of the key reasons for bundles is to incentivize a user into buying more than one item, often by giving them a discount for ordering in a certain combination. With bundles in WHMCS, you can set up discounts to apply based on any of a number of requirements. Those requirements can be restrictions on any of the following:

  • Actual Products in the Cart
  • Billing Cycle
  • Selected Configurable Options
  • Selected Product Addons
  • Domain TLD/Extension
  • Domain Registration Period
  • Domain Addons

Setting Up a New Bundle

Bundle Item Configuration
Bundle Order Summary Requirements Not Met

To set up a new bundle:

  1. Under the Options heading, choose Create New Bundle.
  2. Enter a name for the bundle, a description (optional), and the valid from and to date (by default, one month from the current date).
  3. Check the No Expiry option for unlimited uses, or enter the maximum number of uses (select 0 for unlimited).
  4. Save to create the bundle. A new option, Add Another, will appear in the bundle items section.
  5. Click the link to open the item configuration screen.
  6. Choose the type of item you're adding (product or domain).
  7. Configure the options for that item. Any options you select here from the billing cycle, addons, configurable option values, qualfiying TLDs, registration period, and domain addons become requirements for that bundle. The user must select them to be able to proceed with the bundle order process. The system will also preselect any cycle, addon, and option requirements for the user during the order process.
  8. Use the Price Override field to grant a discount for an item when the order has met all of the requirements for the bundle. This requires that all items in the bundle are in the cart and that all the requirements above match this. The price override replaces the price of the product or domain (with separate price override fields for each). This price must include both the main product and any configurable options you have selected (excluding addons).
  9. When adding a product that contains configurable options to a bundle, select the Restrict checkbox to preselect the selected option during ordering and require it for the bundle.
  10. For a hosting-based product or any that should include a domain, enable any of the domain-related requirements for the bundle item in order to require a domain. For example, select all the Qualifying TLDs, or select a registration period for which the client must order the domain.

NOTE: The Price Override field overrides the base product price. Any addons or configurable options the client chooses will be additional to the normal price. If you need to discount addons and configurable options as well, a promotion code may be more appropriate.

Using Bundles

Usually, you will link to bundles directly from the product information pages of your site. This is similar to direct order links for individual products (cart.php?a=add&pid=X), but bundles require a bundle ID instead of a product ID. WHMCS provides the link for you to use on the bundle edit screen within the admin area. For example:

http://www.example.com/whmcs/cart.php?a=add&bid=X

You may also choose to offer some bundles on your order form itself. To do this, check the "Show on Order Form" checkbox in the bundle configuration options. Doing this for one or more bundles adds a new order form category, "Product Bundles", within the cart. This category lists your bundle offerings and with the description you set.

Notes

For bundles where there are multiple instances of the same product in the bundle, "Allow Multiple Quantities" on the product should be disabled otherwise the bundle will not work as expected.