Products and groups
Create what you sell, set prices per billing cycle and currency, choose how it is provisioned, and organise products into groups.
A product is something customers can order, with one or more prices. Groups organise products on the storefront and decide which plans a customer can switch between. Both live under Products in the admin menu.
The Products list#
The list has four tabs: All, Active, Inactive and Hidden from store. Columns show the group, the module, the cheapest price, the number of live services (active or suspended) and the status. Click a row to edit it. New product opens the form.
Creating a product#
The form has these cards.
Product#
| Field | Notes |
|---|---|
| Name | Required. |
| URL slug (optional) | Used in the store address, /store/your-slug. Lower case letters, numbers and hyphens. Blank generates one from the name. |
| Group (optional) | The group it appears under. |
| Ask the customer for… (optional) | A prompt such as "Domain name". When set, the customer must answer it at checkout, and the answer is saved as the service's label. |
| Description (optional) | Shown on the store. If it has two or more lines, each line becomes a tick-list item, so put one feature per line. A single line is shown as a paragraph. |
| Active | Can be ordered. |
| Show in store | Lists it on the storefront. Turning it off hides the product from the store but keeps existing services. |
| Tax exempt | Leaves the product out of the taxable amount on invoices. |
Pricing#
Add one row per billing cycle and currency with Add price. Each row has a Billing cycle, Currency, Price and an optional Setup fee. Enter amounts in normal units, for example 12.50.
Billing cycles are: One time, Monthly, Quarterly, Every 6 months, Annually, Every 2 years and Every 3 years. Each cycle can have only one price per currency.
Customers see prices in their own currency, or in the store currency if the product has no price in theirs. A product with no price in either is not shown in the store. See Taxes and currencies.
When a product has several recurring cycles, the store shows "Save N%" next to a longer cycle that costs less than repeating the shortest one.
Trial and plan changes#
- Free trial (days): 0 means no trial. The service starts at once and is first invoiced when the trial ends. Each customer gets one trial per product.
- Require a saved payment method to start a trial.
- Customers can change plan: lets customers move to other plans in the same group from the client area. This also needs Let customers change plan themselves turned on in Settings → Billing.
See Free trials and Plan changes.
Metered usage#
An optional section for usage-based pricing, billed after each period on the renewal invoice. See Usage-based billing.
Provisioning#
Module chooses what happens when the product is paid for. None (manual service) means nothing is created automatically and you handle it yourself. Enabled provisioning plugins appear in the list, and picking one reveals the fields that module needs for the product, such as a package name. See Servers.
Deleting a product#
Administrators can delete a product from the danger zone at the bottom of its page. A product with active, suspended or pending services cannot be deleted. Mark it Inactive instead to stop new orders.
Groups#
Groups are managed in the Groups card below the product list. Each row has a Name and an Order number (lower numbers come first). Edit a row and press Save. To add one, type a name under New group and press Add group.
On the storefront, each group with at least one orderable product appears as a section with its name as the heading. With more than one group, a tab bar at the top jumps to each section. Products without a group are listed after the groups.
Deleting a group does not delete its products. They become ungrouped. Only administrators can delete groups.