Learn what system fields are and how they are used in the Booking Form and Guest Form, including editing fields.
New to the Booking Form? Read the first article in this series for an introduction to the Booking Form.
✓ Soho | ✓ Pro | ✓ Plus | ✓ Enterprise | ✓ Flex |
Manage > Layout > Booking Form
What more do I need to use this feature?
- Admin permissions to manage your account.
Which Checkfront version supports this feature - classic, new or both?
- The Booking Form feature is available to both those using items (Inventory > Items), a key feature of our classic version of Checkfront, and those using products (Inventory > Products), a key feature of our newest version of Checkfront.
![]() |
New to Checkfront - Products ✨ Products (Inventory > Products) is the successor feature to items (Inventory > Items) and is available in our newest version of Checkfront. Not yet on our newest version and interested in upgrading? Please get in touch with our Technical Support team for more information. Discover more product-related help articles here: Products (New). |
System Fields
Back to top![]() |
Important!Checkfront has a set of pre-defined Booking Form and Guest Form fields (system fields). These are used to populate information in your database and serve a specific role in the system. Their Booking Form field IDs identify these. If you choose to remove these fields from your Booking Form, then please note that certain functionality could be lost, for example:
It's recommended that you do not replace these options. You may, however, archive them if not required. First, make sure that your Payment Provider does not require the fields. Additionally, we do not recommend using all of the Customer name fields together, eg. customer_name along with customer_first_name and customer_last_name, as this may lead to Payment Providers not processing payments successfully. Please note that the system fields currently support English language strings only. |
Working with booking form fields
Back to topYou can access and view the Booking Form field IDs by clicking on Edit next to the matching Booking Form field (Manage > Layout > Booking Form > Booking Details).
The Booking Form field ID is listed within the General tab of the Edit Form Field modal. If the Booking Form field is a system field, then the ID is read-only.
Below, is a list of the standard Booking Form field IDs that match the default booking fields that come with your Checkfront account.
![]() |
Use All Lowercase for Booking ID FieldsAll Booking Form field IDs must be entered in lowercase letters in order for the resulting data to be captured in reports. For example...
|
Value | Description | Additional Details |
customer_prefix |
Prefix to the Customer's Name. |
Comes with Mr, Mrs, & Miss by default, but more can be added if required. |
customer_name |
Full name (first & last) of the Customer. This is the default field for collecting this information. |
You can replace this with both customer_first_name and customer_last_name, if needed. Past booking information is retained and reportable. |
customer_first_name |
First name of the Customer. |
|
customer_last_name |
Last name of the Customer. |
|
customer_email |
Customer e-mail address. |
|
customer_phone |
Phone number of Customer. |
|
customer_address |
Street address of the Customer. |
|
customer_city |
Customer city of residence. |
|
customer_country |
Customer country code. |
Dropdown with detected country auto-selected. |
customer_region |
Customer state or province. |
Dropdown with detected region auto-selected. For the regions to appear in the dropdown, you must also use the customer_country field. If you do not, the field does not populate properly. |
customer_postal_zip |
Postal or zip code. |
The label of the matching Booking Form field automatically changes based on the selected country; custom field substitutions do not. |
note |
Note that can be created at the time of booking. |
|
customer_email_optin |
The Stay up-to-date on our newsletter field is only displayed when the Mailchimp or Constant Contact integrations are activated. |
|
booking_language |
The language of the booking. This is a special field that only appears on the booking form if you have activated additional languages in your system. It is visible to Staff members only. |
This enables your Staff to change the language of the notification sent out to the Customer when a booking is complete. Only the currently active languages are displayed in the dropdown menu. |
Working with guest form fields
Back to topYou can access and view the Guest Form field IDs by clicking Edit next to the matching Guest Form field (Manage > Layout > Guest Form > Booking Details).
The Guest Form field ID is listed within the General tab of the Edit Form Field modal. If the Guest Form field is a system field, then the ID is read-only.
The system reserves the following fields and, therefore, cannot be used as IDs on the Guest Form.
Value | Description | Additional Details |
guest_name |
Full name (first & last) of the Guest. This is the default field for collecting this information. |
You can replace this with both guest_first_name and guest_last_name, if needed. Past booking information is retained and reportable. |
guest_first_name |
First name of the Guest. |
|
guest_last_name |
Last name of the Guest. |
|
guest_email |
Guest e-mail address. |
|
guest_phone |
Phone number of Guest. |
|
guest_address |
Street address of the Guest. |
|
guest_city |
Guest city of residence. |
|
guest_country |
Guest country code. |
Dropdown with detected country auto-selected. |
guest_region |
Guest state or province. |
Dropdown with detected region auto-selected. For the regions to appear in the dropdown, you must also use the guest_country field. If you do not, then the field does not populate properly. |
guest_postal_zip |
Postal or zip code. |
The label of the matching Booking Form field automatically changes based on the selected country; custom field substitutions do not. |
< Configuring advanced booking form fields > | Archiving booking form fields >