Skip to main content

Documentation

Full Features
Configuring Custom Form Fields
# 226
Last edited on 31 October 2026

Full With custom form fields you ask your customers additional questions while they book, for example for a voucher number or a membership number. This article shows how to create fields, tie them to conditions and where to find the answers later.

This feature is available from the Full Plan onwards.

1. Creating a field

  1. Go to JoomBook → Settings → Form Fields.
  2. Click "New field".
  3. Fill in the details (see table) and save.
SettingMeaning
Field labelShort name of the field, for example "Gift voucher". Required. The answer appears under this name in the tooltip, on the appointment, in the e-mails and in the booking summary.
StatusEnabled or Disabled. Disabled fields do not appear in the booking wizard.
Question / textThe question the customer sees in the booking wizard, for example "Do you have a gift voucher?". If left empty, the field label is shown.
Field typeText (single line), Text (multi-line), Number, Checkbox, Dropdown list or Date.
Required fieldThe customer can only continue once the field is filled in. This applies only while the field is visible for the booking.
ChoicesOnly for a dropdown list: one choice per line, for example "Yes" and "No".
Help textOptional hint shown below the field in the booking wizard.

In the list of fields, the arrows ▲ and ▼ set the order in which the fields appear in the booking wizard.

2. Conditions: when a field appears

Without a condition, a field appears for every booking. In the section "Conditions - when the field appears" you narrow this down:

  • Only at locations: the field appears only if the customer has chosen one of the ticked locations.
  • Only for services: the field appears only if the customer has chosen one of the ticked services.
  • Only if field … has the value: the field appears only once another field has received a specific answer. For a checkbox, the value "1" stands for ticked. For a dropdown list, enter the choice exactly as it is written in the list.

For locations and services, "nothing ticked" means no restriction. If several conditions are set, all of them must apply. A dependent field also appears only if the field it depends on is visible itself. This lets you chain questions.

3. Two examples

Asking for a voucher number only when needed

  1. Field "Voucher": field type Dropdown list, choices "Yes" and "No", question "Would you like to redeem a voucher?".
  2. Field "Voucher number": field type Text (single line), Required field, condition Only if field "Voucher" has the value "Yes".

Customers who choose "Yes" must enter the number. Everyone else never sees the second question.

Membership number at one location only

Field "Membership number", field type Text (single line), and under Only at locations tick just that location. Bookings at other locations stay unchanged.

4. What the customer sees

The fields appear in the booking wizard as a step of their own, "Additional details", before "Your details". If no field is visible for the chosen booking, the step is skipped entirely. If a required answer is missing, the wizard asks the customer to complete the required fields. In the step "Confirm booking" the customer sees the answers once more.

When the booking is made, JoomBook also checks the answers on the server, using the same conditions as the wizard.

5. Where to find the answers

  • On the appointment: the edit panel shows them in the section "Additional details from custom form fields".
  • In the calendar tooltip: as the row "Additional details". This row is switched off at first. Switch it on via the gear icon above the calendar, tab "Tooltip".
  • In the e-mails: in the booking confirmation and in the confirmation of a booking request sent to the customer, and in the notifications to staff and admin.

Everywhere, the short field label is shown, not the longer question.

Existing appointments stay as they are: every booking stores the answers together with the field label that applied when it was booked. Renaming or deleting a field later does not change appointments that have already been booked.

6. Privacy

The answers belong to the appointment. When you delete a customer's data, or JoomBook anonymises old customer data automatically, the answers are removed as well. Only ask for what you really need for the appointment.


Joomla! Logo
JoomBook is not affiliated with or endorsed by The Joomla! Project™ or Open Source Matters, Inc. The Joomla!® name and logo are registered trademarks of Open Source Matters, Inc. in the United States and other countries.

Copyright © · JoomBook