Booking Form & Field Editor: System Fields

System Fields

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. These are identified by their Booking Form Field ID. If you choose to remove these fields from your Booking Form, please note that certain functionality could be lost, for example:

customer_email. The corresponding field is required to send email Notifications to Customers.
customer_country and customer_region. The corresponding fields are pre-filled using GeoIP detection, custom field substitutions would not be.
customer_postal_zip. The corresponding field is automatically changed based on the selected country, custom field substitutions would not be.

It's recommended that you do not replace these options. You may, however, Archive them if not required (be sure your Payment Provider does not require them either).

Please note also that the system fields currently support English language strings only.

- Booking Form Fields

Booking Form Fields

You can access and view the Booking Form Field IDs by clicking on Edit next to the corresponding Booking Form Field (Manage > Layout > Booking Form > Booking Details).

Edit Form Field

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 correspond with the default Booking Fields that come with your Checkfront account.

Use All Lowercase for Booking ID Fields

All Booking Form Field IDs must be entered in lower case letters in order for the resulting data to be captured in reports. For example...

X Incorrect: Customer_name or Customer_Name
✓ Correct: customer_name

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_address

Street address of the Customer.

customer_city

Customer city of residence.

customer_email

Customer e-mail address.

customer_country

Customer country code.

Dropdown with detected country auto-selected. You may enter a default value for the country in the field provided. If you were to enter 'MX' for Mexico, this would automatically show to all Customers, regardless of where they are located. They can, however, change this if required.

customer_region

Customer state or province.

Dropdown with detected region auto-selected In order for the regions to appear in the drop-down, you must also be using the customer_country field. If you do not, the field will not populate properly.

You may also choose a default value for the region by entering it in the field provided. This will show automatically to the Customer, who can then change it if required.

customer_postal_zip

Postal or zip code.

The label of the corresponding Booking Form Field automatically changes based on the selected country, custom field substitutions would not.

customer_phone

Phone number of Customer.

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 either 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 that will be sent out to the Customer when a booking is complete. Only the currently active languages will be displayed in the drop-down menu.

- Guest Form Fields

Guest Form Fields

You can access and view the Guest Form Field IDs by clicking on Edit next to the corresponding Guest Form Field (Manage > Layout > Guest Form > Booking Details).

Guest Form Field ID

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 following fields are reserved by the system and therefore cannot be used as IDs on the Guest Form.

guest_name
guest_first_name
guest_last_name
guest_email
guest_country
guest_region
guest_phone
guest_city
guest_address
guest_postal_zip

< Booking Form & Field Editor: Advanced Tab | Booking Form & Field Editor: Archived Fields >

Articles in this section