Checkout Fields
Checkout Fields let you collect extra information from customers during checkout — on a per-product basis. When a product requires specific details to be fulfilled, you can define exactly what questions to ask and how the answers should be entered.
Common use cases:
- A hosting product that needs the customer's domain name before the server can be set up
- A personalised item that needs a name or message to be printed on it
- A service that needs the customer's website URL or account username before work can begin
- A software licence that requires a company name to be embedded in the licence file
How It Works
When a product with Checkout Fields is added to the cart, an Additional Information section appears on the checkout page between the billing details and the payment method. The customer fills in the required fields before placing their order.
Once the order is placed, the answers are saved against the order. You can review them from the order detail page in the admin panel, and the customer can see them on their own order detail page in their account.
Setting Up Checkout Fields
Step 1 — Open the product editor
Go to Admin Dashboard > Products and open the product you want to configure, or create a new one.
Step 2 — Open the Checkout Fields tab
In the right-hand configuration area, click the Checkout Fields tab (the last tab, with a form icon).
If no fields have been added yet, you will see an empty state with an Add Field button.
Step 3 — Add a field
Click Add Field. A panel will slide open below the list where you can configure the field:
| Setting | Description |
|---|---|
| Label | The question or heading the customer sees, e.g. Domain Name |
| Field Name | A short internal identifier — auto-filled from the label, e.g. domain_name. This is used when the data is stored and should not contain spaces. |
| Type | The kind of input to show (see Field Types below) |
| Required | Tick this if the customer must fill in this field before they can place the order |
| Placeholder | Optional hint text shown inside the input, e.g. example.com |
| Help Text | Optional short note shown below the field to guide the customer |
Fill in the details and click Add Field to save it to the list.
Step 4 — Save the product
Click Save Product in the top-right corner. The fields are now active for this product.
Field Types
When adding a field, you choose the Type from a dropdown. Each type controls what kind of input is shown to the customer.
| Type | What the customer sees | Best used for |
|---|---|---|
| Text | A single-line text box | Short answers: names, usernames, domain names |
| A text box that validates email format | Collecting a specific email address | |
| URL / Domain | A text box that validates URL format | Website addresses, domain names |
| Number | A number input | Quantities, port numbers, ages |
| Textarea | A multi-line text box | Longer answers: messages, descriptions, notes |
| Dropdown (Select) | A dropdown menu of options you define | Choosing from a fixed list |
| Radio Buttons | A set of options to pick one from | Choosing from a short fixed list |
| Checkbox | A single tick box (yes/no) | Agreements, opt-ins, binary choices |
Options (Dropdown and Radio only)
When you select Dropdown or Radio Buttons as the type, an Options section appears inside the editor panel. Click Add Option to add each choice. Each option has:
- Value — the internal value stored when this option is chosen (e.g.
us-east) - Label — the text the customer sees (e.g. US East)
Validation (Text, Textarea, and Number)
For Text and Textarea fields you can optionally set a minimum and maximum character length, and a regular expression pattern to enforce a specific format (for example, to only accept valid domain names). If you set a regex, you can also set a custom error message so customers know exactly what format is expected.
For Number fields you can set a minimum and maximum allowed value.
Reordering Fields
The fields appear on the checkout page in the order they are listed. Use the up and down arrow buttons on the left side of each field row to change the order.
Editing and Removing Fields
- Click the edit (pencil) button on any field row to reopen the configuration panel and make changes.
- Click the delete (bin) button to permanently remove a field from the product.
WARNING
Removing a field does not delete the answers already collected on existing orders. Historical order data is preserved. The field simply stops appearing for new purchases.
What Customers See
On the checkout page, customers see an Additional Information section labelled with the number 2 (between Billing and Payment). Each field is shown with its label and — if set — a placeholder and help text.
Fields marked as Required must be filled in before the order can be submitted. If a required field is left blank, or if a value does not match the expected format, a clear error message is shown directly below the field using the field's label name (for example, "The Domain Name field is required.").
Viewing Submitted Answers
In the Admin Panel
Open the order from Admin Dashboard > Orders and click View. If the purchased product had Checkout Fields, a Provisioning / Custom Details section is shown in the order detail page, listing each field name and the value the customer provided.
In the Customer's Account
The customer can also see their submitted answers by visiting My Account > Orders and opening the relevant order. The answers appear in a Service Details card on the order detail page.
Frequently Asked Questions
Can I add Checkout Fields to any product type? Yes. Checkout Fields work with both one-time purchase products and subscription products.
Can different pricing plans on the same product have different fields? No. Checkout Fields are defined at the product level and apply to the product regardless of which pricing plan the customer chooses.
What if a customer adds two different products with Checkout Fields to their cart at the same time? Each product's fields are shown as a separate group in the Additional Information section, clearly labelled with the product name. The customer fills in all groups before checking out.
Can I make all fields optional? Yes. Simply leave the Required checkbox unticked when adding or editing each field. Optional fields are still collected if filled in, but the customer can leave them blank.
Where are the submitted answers stored? Answers are saved securely in your database and tied to the specific order item. They are never shared with payment gateways.