# Forms

# Summary

This section of the CMS is used to maintain your Enquiry Forms. These are then output on pages via the [Modular Block](https://bookstack.iconography.co.uk/books/general/chapter/modular-blocks "Modular Blocks") system, specifically as part of an [Enquiry Form](https://bookstack.iconography.co.uk/books/general/page/enquiry-form "Enquiry Form") content block.

#### Key to icons

![Edit](https://ixo.iconography.co.uk/images/cms/icons/edit.gif) = edit

![Delete](https://ixo.iconography.co.uk/images/cms/icons/delete.gif) = delete

## Setup

### Form Details

<table border="1" id="bkmrk-field-purpose-name-e" style="border-collapse: collapse; width: 100%; border-width: 1px;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><thead><tr><td>Field</td><td>Purpose</td></tr></thead><tbody><tr><td>Name</td><td>*Enter the name of the form*

*This will not be output on the website*

</td></tr><tr><td>Recipient Email Address</td><td>*Enter the recipient for all enquiries from this form*

*Different forms may have different recipients, e.g. one form for complaints, and another for sales enquiries*

</td></tr><tr><td>Confirmation Message</td><td>*Enter a thank you message to be shown to the user after they fill out the form.* </td></tr><tr><td>Include Mailing List Signup?</td><td>*Output the [mailing list signup](https://bookstack.iconography.co.uk/books/mailing-list/page/mailing-list-signup "Mailing List Signup") as part of the form*</td></tr><tr><td>Use Anti-Spam CAPTCHA</td><td>*Require users to fill out an anti-spam CAPTCHA prior to submission*

*If enabled, users will not be able to submit a response without completing the CAPTCHA*

</td></tr></tbody></table>

### Form Fields

Use the controls to add new elements to your form. These may be dragged and dropped to alter their sequence.

#### Edit Fields

<table border="1" id="bkmrk-field-purpose-field-" style="border-collapse: collapse; width: 100%; border-width: 1px;"><colgroup><col style="width: 50.0596%;"></col><col style="width: 50.0596%;"></col></colgroup><thead><tr><td>Field</td><td>Purpose</td></tr></thead><tbody><tr><td>Field Label</td><td>A label that will appear above the field</td></tr><tr><td>Placeholder Text</td><td>The text that is shown within this field on form load

May be left blank to show no text

</td></tr><tr><td>Field Type</td><td>Use this to adjust the Field Type for this field (see below)

</td></tr><tr><td>Required Field</td><td>If toggled, a customer will not be able to submit the form without entering data in this field

</td></tr><tr><td>Delete this content</td><td>Use this to delete a field

</td></tr></tbody></table>

#### Field Types

<p class="callout info">Various fields will include validation, e.g. a numeric field will only accept numbers</p>

<table border="1" id="bkmrk-field-purpose-text-s" style="border-collapse: collapse; width: 100%; border-width: 1px;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><thead><tr><td>Field</td><td>Purpose</td></tr></thead><tbody><tr><td>Text</td><td>*Short text, e.g. 'name'*</td></tr><tr><td>Text Area</td><td>*Longer text response, e.g. 'comments'*</td></tr><tr><td>Email Address</td><td>*User enters an email address*

*Format is validated, but individual numbers are not checked*

</td></tr><tr><td>Telephone Number</td><td>*User enters a phone number*

*Format is validated, but individual numbers are not checked*

</td></tr><tr><td>Numeric</td><td>*User enters a number*

*Validated*

</td></tr><tr><td>Date Selector</td><td>*User enters a date*

*Validated*

</td></tr><tr><td>File Upload</td><td>*Allows the user to upload a file - this will be attached to the email sent to the recipient address*

*Users may not be able to upload large files*

</td></tr><tr><td>Radio Buttons</td><td>*Multiple choice questions*</td></tr><tr><td>Drop-down List</td><td>*Allows the user to select a response from a list*</td></tr><tr><td>Checkbox</td><td>*Allows a user to select multiple responses from a list*</td></tr></tbody></table>