Config Options
Configurable Options in WHMCS allow customers to customize a product at order time — for example, choosing a control panel, selecting RAM/storage for a VPS, or adding an SSL certificate. HmSingleOrderAddon renders these inline on the order form.
Setting Up Configurable Options in WHMCS
- Go to Products/Services → Configurable Options
- Click Create a New Group
- Name the group and assign it to the products that should show these options
- Add individual options within the group
Option Types
WHMCS supports the following configurable option types — all are supported by the order form:
| Type | Display Style |
|---|---|
| Dropdown | Standard <select> dropdown |
| Radio | Radio button group |
| Checkbox | Checked for add-ons (included/not included) |
| Quantity | Numeric input |
| Text | Free-text input |
How They Appear in the Order Form
When a product with configurable options is loaded in the order form:
- A Configuration section appears below the domain section
- Each option group is shown with its name and the available options
- Pricing for each option is shown inline (e.g. ”+$5.00/month”)
- The order summary updates dynamically as customers make selections
Tip
Configurable option pricing is added to the base product price in the order summary. Customers see a live total that updates as they change selections.
Pricing per Billing Cycle
If your configurable options have different prices for different billing cycles (e.g. a backup add-on costs $1/month or $10/year), the order form shows the price for the currently selected billing cycle.
When a customer changes the billing cycle, all configurable option prices update automatically.
Required vs Optional Options
- Required options (no empty/none choice) must be selected before the customer can proceed to checkout
- Optional options include a “None” option and can be left unselected
Configurable Options vs Product Add-Ons
WHMCS has two similar features — make sure you’re using the right one:
| Feature | Use Case |
|---|---|
| Configurable Options | Per-product options shown at order time |
| Product Add-Ons | Separate products added to an existing service |
HmSingleOrderAddon supports Configurable Options at checkout. Product Add-Ons are managed from the WHMCS client area after the initial order.
Custom Fields
In addition to configurable options, products can have Custom Fields (set in Products/Services → Edit Product → Custom Fields tab). These appear as form fields in the order form:
- Text fields — for notes, preferences, etc.
- Dropdown fields — for fixed-choice selections
Custom fields can be marked as Required or optional.
Note
Custom fields appear below the configurable options section. Required custom fields must be completed before the order can be submitted.