What Are Configurable Options?
Configurable options let clients choose add-ons and customisations when placing an order — things like extra disk space, RAM upgrades, backup frequency, or a control panel preference. Each selection can add its own price on top of the base product price.
Architecture
The configurable options system has three levels:
Option Group
└── Option (type: dropdown / radio / checkbox / quantity)
└── Values (label + optional pricing per cycle per currency)
- Option Groups are containers. One group can be linked to multiple products.
- Options define the choice type and label.
- Values are the individual selectable items within an option.
See Option Groups, Options & Values for how to create them.
Option Types
| Type | Behaviour | Example |
|---|---|---|
dropdown |
Select one value from a list | "Disk Space: 10 GB / 20 GB / 50 GB" |
radio |
Select one value (shown as radio buttons) | "OS: AlmaLinux / Ubuntu / Debian" |
checkbox |
Add or remove (binary on/off) | "Daily Backups: add for $2/mo" |
quantity |
Enter a number; price × quantity | "Extra IP Addresses: 1–10" |
Linking Options to Products
Option groups are linked to products on the product's Options tab. One group can serve multiple products — for example, a "Disk Space" group can be linked to both your Starter and Business plans.
On the Order Form
When a client orders a product that has option groups linked:
- Each option group is shown as a section on the order form.
- Options appear in the configured sort order.
- Prices for each value are shown inline (e.g. "+$2.00/mo").
- The order summary updates in real time as options are selected.
How Options Are Stored
Selected options are stored on the order item as a JSON blob. Example:
{
"disk_space": "50 GB",
"daily_backups": true,
"extra_ips": 2
}
This JSON is also stored on the service record and passed to the provisioning module so the Panel can apply the correct resource limits.
Pricing
Each option value can have its own pricing per billing cycle per currency. Pricing is additive — it is added on top of the base product price. Quantity options multiply the per-unit price by the entered quantity.
See Pricing per Option Value for details.