When you create a custom form for your Self-Book events you can have a maximum of 25 form fields that can be added. There are a total of 29 form types to choose from. There are four groups of form field types: fields that affect the event, fields that deal with payments, autofill fields, and custom form fields. Below the types of form fields are listed below by group.
All of your form fields have these features:
- Label - The ability to choose a custom name for your form fields.
- Type - The ability to choose what type of form field you want to use (form field types listed further down in this article)
- Value - The ability to add extra values for your chosen form fields (examples of this are listed for the form field types below)
- Placeholder - The ability to add placeholder text. Placeholder text is displayed until your visitor starts typing. Use it to give them an example of a response.
- All of your form fields can also be edited by your users or you can make the "read-only."
- Field Visibility - Your form fields can be visible by only those with edit rights, visible to everyone (visitors with and without edit rights), or hidden from everyone.
- Forms fields can be required or optional.
- Help Text - The ability to add help text. Help text is displayed when your visitor hovers over the question mark to the right of your form field. Use it to give them additional information or explanation.
- Append to Event Text - The ability to append the information your visitors fill out in the form field to the title of the event.
- Append to Event Notes - The ability to append the information your visitors fill out in the form field to the event notes.
Event Fields
You can only add one of each of these form fields to your form. These are the form fields that affect how your events work and look. See the image below for the list of Event Fields and how they'll look once they're added to your form.
Event Text - The text entered into this form field will be used as the title of your event.
Event Start Date - This form field allows you or your visitors to choose the start date for your event. You can type "today," "current," or a specific date like "06/07/17" into the "Value" text box to suggest a default date to your visitors.
Event Thru Date - This form field allows you or your visitors to choose what date your event goes through. You can type "today," "current," or a specific date like "06/07/17" into the "Value" text box to suggest a default date to your visitors.
Event Extent - This form field allows you to choose a specific number of days that your visitor is booking. For example, if you hide this form field and choose 7 days, then every visitor who fills out this form will automatically create a booking that lasts for 7 days. This can be preferable to the "Event Thru Date" since your visitors can't accidentally pick the wrong number of days.
Event End Date - This form field allows you or your visitors to choose the end date for your event. You can type "today," "current," or a specific date like "06/07/17" into the "Value" text box to suggest a default date to your visitors.
Event Start Time - This form field indicates the start time for the event. You can add a default time to the "Value" text box using the format hh:mm am/pm (ex. 11:00 am).
Event Length - This form field indicates the duration of the event. You can suggest a default length of time to the "Value" text box by typing in "default" (which is one hour) or by typing in a time interval like 1:30 (one hour and thirty minutes).
Event End Time - Rather than specifying a specific duration for your event (ex. Event Length) you can instead choose a specific end time for your event.
Event Repeat - Visitors can use this form field to decide the repeat schedule of their event. You can also add a value of 0 through 12 to choose a default repeat schedule for your visitors. Below is a list of what number corresponds with what repeat schedule, with "0" being "no repeat."
- Daily
- Weekly
- Monthly
- Annually
- Every Weekday (M-F)
- Every Weekend (Sat, Sun)
- Every Mon, Wed, Fri
- Monthly, same weekday & same week
- Monthly, same weekday & last week
- Bi-weekly (every other week)
- Bi-monthly (every other month)
- Quarterly (every 3 months)
Event Details - Text entered into this field will be displayed when someone hovers the mouse over the event text in the calendar after the event has been submitted through the form.
Event Colors - This form field adds a selection of colors to your form so that your visitors can choose the color of their event. If you mark this field as "hidden" then you can choose the default color of the events that your visitors submit. The colors are numbered 0-14 (with 0 being no color) and then you can add "1" to choose a default event highlight, "2" to make the event text bold, and "3" to make the event text bolded and highlighted. For example, if you wanted to make the default event color number 2 from the chart below (the one with the peach background and blue text) but you wanted the highlighted color you would enter "2;1" into the "Value" text box.
Event Link Text - This form field allows you or your visitors to choose the name of your link.
Event Link URL - This is the form field where you enter the URL for your link.
Event Link Target - You can choose for submitted links to open in a new window ("_blank"), to open in the same browser as the link was clicked in ("_self"), to open in the current browser window ("_top"), or to open in a pop-up window ("popup").
Event Link Details - Text in this form field is what appears when you hover over the link in the calendar after the event has been submitted to the calendar.
Event Map Link Text - This form field allows you or your visitors to choose the name of a map link.
Event Map Link Address - This form field allows you or your visitors to enter in a link to a map (ex. you can copy a map link from Google Maps and paste it into this text field).
Event Tag - This form field pulls all of the active Event Tags in your calendar and adds them to your form. Your visitors can then choose the Event Tag they want to be added to the event from your calendar. If you have this field hidden you can choose the default Event Tag that is added to submitted events by typing in the name of the default Event Tag into the "Value" text box.
Event Notes - This form field generates a link to a pop-up text editor where your visitors can type in event notes. If you want to add a default event note you can do so by typing in "title ; event note text ; prompt" into the "Value" text box. "Title" will be the title of the event note, "event note text" will be replaced with what you want to be added to the notes, and "prompt" will be the text that people see as the link to the event notes.
Event Self-Book - This allows you or your visitors to choose a Self-Book template to add to the event.
Payment Fields
PayPal Quantity Dropdown - This form field is integrated with Paypal and allows you to choose a quantity of some item that is all at the same set price. For example, if you are selling tickets that are all the same price this form field allows you to sell all of the tickets at the same price and only have your visitors choose the quantity. As you can see from the example above the price reflects the number of tickets chosen. This also means there will only be one Hosted Button ID from PayPal.
In order to use this form field you will need to type your item values into the "Value" text box in this format; "title : quantity value ;." Using the ticket example above this is what the values will look like in the "Value" text box:
1 Ticket $20.00 USD:1;2 Tickets $40.00 USD:2;3 Tickets $60.00 USD:3;4 Tickets $80.00 USD:4
PayPal Multi-Item Dropdown - This is the PayPal form field if you have several options of what form visitors can purchase but they're not all the same price. In the example above there are three art classes. Each of these classes have their own unique pricing and you're not choosing quantities of the class to buy. Each class in this list has its own unique Hosted Button ID that you will need to get from PayPal and then enter the button ID number and the title of your event into the "Value" text box like this: "title : paypalbutton id ;". Below is an example of what the values would look like in the text box:
Art Class 1 $30:C597WG3E3YRJV;Art Class 2 $40:C597WG3E3YQVG;Art Class 3 $40:C597WG3E3YWTH
Autofill Fields
The "Autofill Dropdown" fields allow you to have the information automatically filled in once your form visitor selects an option from a dropdown menu. This makes it easier for your visitors to have the right form information submitted. You can even hide the automatically filled-in forms from your visitors so that they can't see the autofill fields, but you'll see the information when the form is submitted. See the example below:
To define what information will be auto-filled you will need to enter something like the text below into the "Value" text field:
Select One: |
East : #2=New York, #3=35633 |
Central : #2=Chicago, #3=54567 |
West : #2=San Francisco, #3=94118
As you can see from the example above what number you input determines what information goes where. For example, if your visitors select the "East" option then #2 auto-fills the second information field and #3 auto-fills the #3 field. You have to define where your information is going if you want the autofill fields to fill correctly.
Custom Form Fields
Unlike the other form field types, you can add more than one of each of these form fields to your form.
Custom Form Email - Anything that visitors type into this text box will need to have an email format ( e.g. aaa@bbb.ccc ).
Custom Form Email Opt-out - If you have visitors enter their email address into your form, this form field adds a checkbox that allows your visitors to opt-out of receiving emails. If you want to choose a default option for the form you can type "notchecked" or "checked" into the "Value" text box.
Custom Form Phone - This form field allows visitors to enter in their phone number. Only digits, ( ), -, ., x and spaces are allowed in this form field. You can also append this field to your submitted events and the phone number will appear as a live link that you can click on.
Custom SMS Phone for Texts - This form field allows your visitors to fill out a contact phone number that you can then use to send SMS texts to. You can also append this field to your submitted events and the phone number will appear as a live link that you can click on.
Custom Form Text - This is a single-line text box that you can use to ask for additional information or details from your visitors.
Custom Form Multi-line Text - This is a multi-line text box that you can use to ask for additional information or details from your visitors.
Custom Form Section Title - This form field helps you organize your form into sections by allowing you to label them.
Custom Form Number - only digits allowed
Custom Logo - If you have added a Custom Logo to your account header then adding this field to your form will automatically add whatever logo you have uploaded to your form.
Custom Form Number - You or your visitors can choose a custom form number to be associated with the event.
Custom Form Date - This form field allows you or your visitors to choose a specified date. You can type "today," "current," or a specific date like "06/07/17" into the "Value" text box to suggest a default date to your visitors.
Custom Form Time - This form field allows your visitors to choose a specified time. You can add a default time to the "Value" text box using the format hh:mm am/pm (ex. 11:00 am).
Custom Form Length - This form field indicates a custom time duration. You can suggest a default length of time to the "Value" text box by typing in "default" (which is one hour) or by typing in a time interval like 1:30 (one hour and thirty minutes).
Custom Form Dropdown - This is a custom drop-down menu of options that you can add to your form for visitors to select from. You can add options into the "Value" text box by typing the options like this: "title ;" or "title : value ;." See the example below:
Option 1; Option 2; Option 3
Custom Form Checkbox - This form field allows you to add one checkbox option to the "Value" text box. You can have the box checked by default by typing "value ; default" into the text box (e.g., "yes;checked" or "lunch" )
Custom Form Choice - This form field allows you to list several options with radio buttons next to each option. This allows your visitors to choose one of the options listed by clicking on the radio button next to the option they want. To list your options you will need to type your options into the "Value" text box like this: "title ;" or "title : value ;."
Terms and Conditions - This form field allows you to add title text, a URL, and text for your URL to any Terms of Service or Conditions that you may want to link to your form for your visitors to see when they fill the form out.