Overview
Each configurable option value can have its own pricing matrix (per billing cycle, per currency, with a setup fee). Option pricing is additive — it is added on top of the base product price to form the order total.
A value with no pricing rows is free (no charge added).
Accessing Option Value Pricing
- Go to Admin → Configurable Options → [group].
- Expand the option, then click the Pricing button next to the value you want to configure.
- The pricing matrix opens in a modal or inline panel.
Pricing Matrix Structure
The matrix works identically to the product pricing matrix:
| Cycle | Price | Setup Fee |
|---|---|---|
| Monthly | e.g. 2.00 |
e.g. 0 |
| Quarterly | e.g. 5.50 |
|
| Annual | e.g. 20.00 |
|
| … |
- Leave a cell blank to disable that cycle for this value.
- Enter
0for a free option with no setup fee. - Values are entered as decimals; stored as BIGINT cents.
[!TIP] You only need to add pricing rows for cycles that the linked product also offers. If the product has no quarterly pricing, the quarterly option value row will never be used.
Setup Fees on Option Values
Like product setup fees, option value setup fees are:
- Charged on the first invoice only.
- Shown as a separate line item (e.g. "Setup fee for Daily Backups").
- Not charged on renewal invoices.
How Options Appear on the Invoice
Each selected option that has a non-zero price appears as its own line item on the invoice:
Business Hosting Plan (Monthly) $19.99
↳ Disk Space: 50 GB + $5.00
↳ Daily Backups (setup fee) + $2.00
↳ Daily Backups + $2.00
──────────────────────────────────────────────
Total $28.99
Free options (no pricing row or price = 0) are not shown on the invoice.
Quantity Options
For quantity option type, the entered quantity multiplies the per-unit price:
- Value pricing:
$1.00/moper unit - Client enters quantity:
3 - Invoice line item: "Extra IP Addresses × 3 — $3.00/mo"
Quantity is stored in the service's options JSON and used to calculate renewal invoice amounts.
No Pricing = Free
If a value has no pricing rows at all, it is treated as a free add-on. It will still appear in the selected options JSON on the order and service, but will not add any cost. Useful for:
- Default/base values in a dropdown (e.g. "10 GB" at no extra cost).
- OS selections where all options are equally priced (charge via the base product only).