Revision as of 19:33, 7 May 2020

Configurable Options on products allow you to give your clients variables that alter the price of that product. Product Addons let you offer additional items that the client selects. The system bills them seperately from the product.

• Configurable options are defined in groups.
• You can apply groups of options to one or more products.

When should I use configurable options instead of addons?

• If you want to offer a choice of options for a single item (for example, Disk Space, Operating Systems, or Locations).
• If you want to bill the total amount as a single item and not seperately.
• If you want the billing cycle of the addon to match the billing cycle of the product.

When should I use addons instead of configurable options?

• If the item is a one-time service.
• If clients can select the item independantly of other items.
• If you want to bill it on its own cycle (for example, you could bill a dedicated IP address annually regardless of the package cycle).

Configurable Options

Setting up a New Group

1. Go to Setup > Products/Services > Configurable Options > Create a New Group.
2. Enter a name and description (for admin reference only) and choose the products it applies to (you can also do this later).
3. Click Save Changes. The page will reload showing the group details and allowing you to move on to managing options.

Managing Options

To manage options:

1. Go to Setup > Products/Services > Configurable Options and click the edit icon next to the option group you want to modify. At the top of the page, you can edit the name, description, and assigned products.
2. To add a new configurable option, click Add New Configurable Option.
3. A new window will allow you to enter an option name and choose a type. You can select from the following types:
   • Dropdown — Show a menu of options on the order form.
   • Radio — Show a selection of radio button options on the order form.
   • Yes/No — Show a checkbox on the order form that allows the client to turn the option on or off.
   • Quantity — Show an input field on the order form that allows the user to enter an item quantity.
4. Enter the first sub-option value you want to offer for this option (you can set the price after saving).
5. Click Save Changes. The page will refresh with the sub-option showing pricing fields.
6. Enter pricing for all the cycles that the product has enabled.
   • If you selected Yes/No or Quantity for the type, then only one sub-option is necessary.
   • If you selected Dropdown or Radio for the type, use the Add Option field at the bottom of the page to add multiple sub-options.
7. After every addition, click Save Changes to reload the page and set the new sub-options pricing.
8. After you finish configuring your options, click Close Window. This will refresh the underlying page to show the new option.
9. Repeat this process for each option you want to add.
10. After you set up multiple options in the group, use the Sort Order column to define the display order for the options.
11. Click Back to Groups List to complete the process.

Option Types

WHMCS offers a variety of different configurable option types, allowing for choice of the most appropriate input format:

Dropdown

The Dropdown option type displays a standard combo box. This is useful when there are a large number of items to choose from that should require minimal space on the order form.

Yes/No

The Yes/No option type displays a checkbox for the client to select or deselect. This is useful for simple opt-in-or-opt-out questions. Both yes or no are valid values, so the form validation will accept the unchecked state even if this is a required option.

Radio

The Radio option type displays a list of the available options alongside a radio box for the client to choose from. If there are too many options, this can look messy. In that case, we recommend using Dropdown instead.

Quantity

The Quantity option type displays a field that allows the client to enter a number. Specify the unit price in the One Time/Monthly column. The system will multiply it by the quantity that the client selected.

When creating or editing a Quantity option, you can set maximum and minimum vales. You may also allow clients to enter any quantity by leaving both the 'Minimum' and 'Maximum' fields blank. However, you can't specify just a minimum or just a maximum value.

Slider

The slider provides a graphical method for clients to specify a quantity. Like the Quantity option type, you must supply a minimum and maximum quantity and use it in conjunction with all order form templates (except Boxes).

Hiding Options

Hiding is useful for when you want to remove an option that you no longer offer to new signups from the order forms, but don't want to lose the selections for existing customers.

You can hide entire configurable options or just individual sub-options. Do this in the managing options screen by checking the Hidden/Hide box for an option you want to disable.

Important Note: Once you hide an option or sub-option, admin users continue to see it for existing customers.

Note: As of version v5.3 and above, the "Starting From" price on cart.php in the Modern order form template doesn't include hidden configurable options. Prior to this, the price included hidden configurable options.

Friendly Display Names

Sometimes, a module may require you to format a configurable option valu in a certain way, but this might be difficult for visitors to understand. WHMCS can display a friendly name to visitors on the order form, emails, and invoices, but still send the required machine code to the module.

Config Option Friendly Names

To achieve this, use the format "required value|display value". For example:

• Disk Space|Your Web Quota
• 10000MB|10 Gigabytes
• rbx01ssd|French Server - Solid State Drive

Product Addons

For information about product addons, see Product Addons.