--- title: "Understanding the Various Form Fields" source: "https://docs.nexcess.com/software/give/understanding-the-various-form-fields/" description: "The Form Field Manager includes a number of field types. A field type can be as simple as a text input or as advanced as a multi-file upload field. The followin…" vertical: "Software" area: "Give" date: "2015-10-19" last_modified: "2026-07-02" --- # Understanding the Various Form Fields The Form Field Manager includes a number of field types. A field type can be as simple as a text input or as advanced as a multi-file upload field. The following will provide you an overview of each field type and its options. ## Form Field Manager Blocks for the Visual Donation Form Builder The following field blocks are included within the form builder when the Form Field Manager add-on is active. ![](https://docs.nexcess.com/wp-content/uploads/2026/07/AD_4nXdBhPTFa-wezSM7c7_dWLnt1MheYSS6AF2Gnt524qVYix_9HCG4wILxMTdyCyI46EPS7kyvbsqTR0_6a82n8bsGiOHKzP_PUFShPrMdCAEepT0oXCzE8Z1ytgtYKAeBVxLtUSUAlape4IK2lwqAoIVcgMrL.png)### Text Field ![](https://docs.nexcess.com/wp-content/uploads/2026/07/AD_4nXcdoYN8v91MrT1mhy4dafvTF5YyPtQYdcefv4iUfVBHJrNTa50LKhy-SOHg3pCNq3615jmwTqEgEFP8J_hdOWDe071DbKFZcHUK4mKIPto2u2TVlhOwgRdeDz-9A8gPxU970Zo9XhOPJoTKdK3apd5jVdXA.png)The Text Field block adds a plain text input to your form. This can be used for many reasons and is typically the most common field you see used within forms. ### Checkbox ![](https://docs.nexcess.com/wp-content/uploads/2026/07/AD_4nXe8Ivu79LcXUA6bNlEqrwUwEXFmevUhFfz0cYBQ9aGkD8VWdCd7SkKXOBXfNSFu1fQdTeq3J2nWB7Ius0CHa2I_fKN2LnJZlHnNWpdjiFwBvntD_IhhBXEIGM2WrKvUX9Z1pjlmV5DG8zlzWzxIQw5enzc.png)The Checkbox block is useful for creating a multiple choice list of options for donors to complete. When you require this field they have to choose at least one selection. If you want to limit the user to only one selection, consider using a select or radio list. ### Consent ![](https://docs.nexcess.com/wp-content/uploads/2026/07/AD_4nXe7ZJdsWT8TxVY5r-WwQmfXFl98BVW62AXjigjigy7NT7xgY9a2uaXzi55PgobQ3kNhRQLHh1fjv4o_O0UrAdyskg74Gk-XzIG8polI10dKgIpTf06OyRs-Qo2yIVv9pfK11dBx_XshhXH2kNOiKwQ1dKo.png)The Consent block adds a required checkbox and customizable disclaimer text that donors must check in order to make a donation. This is a great option for adding terms and conditions or some other type of agreement-type message. ### Date ![](https://docs.nexcess.com/wp-content/uploads/2026/07/AD_4nXdeFTO5dGSR6zdWbherCeI-9J5m7Zxxv_SMIaTBxuh68fIGsP-L5pWn8aJALJaTFFPPvmr_WONUHe9St6G6Pc-5VyPQauamNJtFVgNG7Yfo8pFKy1YGT-Nmhe-l3rGDBTKWLL38M79H6xRJ4Nhz0sXbR8f2.png)The Date block is a powerful field for capturing dates. You can select from three predefined date formats. ### Dropdown ![](https://docs.nexcess.com/wp-content/uploads/2026/07/AD_4nXcleqFktpStrqNHYcxTUw5XS1m_MyquuYVDvy2unXdxhm1IX3XoHvgshQpf0AEybyUE5NmdSLObg0dIoWIEg4tj8Rca1hFt6F36YGNqUT0msfxd3oWvRyL0JE774R7wPaMallNtsMoqbHMtKhn1IgiXnBmP.png)The Dropdown block adds a dropdown or select field to your form. ### Email ![](https://docs.nexcess.com/wp-content/uploads/2026/07/AD_4nXe6ncIenbtT_9domZ6B-hr8fRCg4C4eYchl2pu9v0nsd-y7m0u-167vEMKCMBCG3AQnRxSXTRJUrHbF84cxmmvfEOlfGKXynK-i0Kg942JiMDLw0LNs0vU68eRIGtZRIZ3T2_1cAhpoUBldWSlclzHL1bU.png)The Email block helps collect more than just the donor’s email address. This field will only accept a valid email address. ### File Upload ![](https://docs.nexcess.com/wp-content/uploads/2026/07/AD_4nXc3OL4OlAZTJs0c7x1Bx_iet0jM3DKo7SNEb9DIf41EuYzOyVfXR00MHVvF_S1aH4YGAp3t7QZJ-dxgiQztppepTwCn4SXubDh8N-eSti7awrVPlAxJG7_9nTqhKHVwXubcHM8oAPt0vDonkaUQNVnrJwo.png)The File Upload block gives donors the ability to upload files on the form. Check the boxes next to the file types you would like to allow to enable additional file types. The file will be uploaded to the Media Library. You can access it there, or in the **Custom Fields** section of the donation details. Bear in mind, if you allow a large number of files (or large file sizes) to be uploaded you will need to take into account the storage of those files and any bandwidth requirements. ### Hidden Field ![](https://docs.nexcess.com/wp-content/uploads/2026/07/AD_4nXfUZ8_5ykQLEcQEvswGXUdcAhMlL3vJm_rZcB3RBRDt-mse3Fq2e_fGrxU_yy_kwoM3vrqaDM64jTlKI7IYYYuuYRfY81YyorGyDOnWTQRCoe8Dw-gd6xoR3Lwz7qklITTHGeG-n7q7BiiMK8UgTyiEAUc.png)The Hidden field block can be used to store information that should not be visible to the donor but can be processed and stored when the donor makes a donation. ### HTML ![](https://docs.nexcess.com/wp-content/uploads/2026/07/AD_4nXcE2a8oDSvlv8kS6HPs0XlKLe13hKOP8gdvrWd6ZyitbfcASXKMbS7pDsZwOwZiriChXfPR-OZsM2Ez9KmvcPgewS2u17PvU_vU8N80dFKZdqBklp6Q7PMYXziQfzcxVYSJy7A8GJ25nwBNmiM2zQH0xWvI.png)The HTML block is for those who know a bit of code. This field allows you to output HTML markup such as text, images, lists, tables, and inline styles (CSS). ### Multi Select ![](https://docs.nexcess.com/wp-content/uploads/2026/07/AD_4nXcVqlHdsGjoa1qNZySNEN8GK10TU3aZ3_1y5DQk_3w5wa6BOFWn_9iLvc7dxHe58sxqbOaSyS87JZwBDHtxWt_IZ9r0JKZ-sKVIJO2AreEo0k3PLB9YB45ExlDA6cUj6XtPEOoy39yVw3DKSugh2-IvTT8I.png)The Multi Select block is a great way to provide donors a list of options to choose from. They can select one or multiple items. If the field is required, the donor is required to choose at least one option. You can choose between creating a dropdown list or a checkbox list. ### Phone ![](https://docs.nexcess.com/wp-content/uploads/2026/07/AD_4nXcaVm2jUZTv3asnALmoQ3_sCtz4JfmJL4UlWZH9SAvyBvtfyVrialys5EPadhyZF50PUIlaiuZNpu4W7IeaswP7KbSPX-PGYjK5eB_ypUFq5ENIQMB8uyx2EsZZcSQTy9bpl_4WSmcpT3jwoh4QTAbp2oWc.png)Use the Phone block to add a phone field to your form. Take note that you can make the field formatted “(###) ###-###” or unformatted “###-###-####” if you like. Utilize the placeholder text to give your donors direction when they are inputting their number. ### Radio ![](https://docs.nexcess.com/wp-content/uploads/2026/07/AD_4nXeCjGxOkRgZ-2wX6wmKfbXjyBKakHzWFcLR5oXUifOsvImKIUa-cggST4WQ1mONs7cG-rPweQ3SWLEfYhmNP7usnfqzfXtJRoRKBKNDSUp6AQzsRwW3R1KSM8ev2MxqNvcDth8YDmhm0v5Zo9b9m0jxVNa_.png)The Radio block allows you to create a set of radio input options that when presented on to the user will give them list of options to choose from. Only one radio may be selected at a time. You may choose which radio field is set by default by clicking the radio next to that item in the admin panel. ### Textarea ![](https://docs.nexcess.com/wp-content/uploads/2026/07/AD_4nXdr88_U_KLjYe94dw7xLrVRUiy8p237c0yZ2nFoNz0skHqN1BIszkTa00gIoDXauKYBkIAt6l_Csd7CyFFYNjzZhfWJPes9JE-U_mDqXV0K2GQjVOVLEYwD5LONmjJEx75urpKhryx5toj3EcwtHftCZg4.png)The Textarea block adds a textarea field to your donation forms. Typically, textareas are used to collect large amounts of textual information such as comments or messages. ### URL ![](https://docs.nexcess.com/wp-content/uploads/2026/07/AD_4nXesMRVXtZnPpZ2Fc5kqYrTUVkzyxHIgFgVqNy3oVp3cLjjrsgA_o1Wn4LrtJt8QwJsfcA_1qpo7IG8-aUKV3pJtg2WG3lDvBQPcsWlWOSAl_5EUm1iyMS8qlov8n3agukKjGiwfuvQSOkPUW65lisVQCMWp.png)The URL block is handy for accepting website addresses in a form field. It will only validate against valid domain names. ## **Additional Options** ### **Display Settings** ![](https://docs.nexcess.com/wp-content/uploads/2026/07/AD_4nXcKQtnwpwpzu80FM3sz3ODHE9hKn-VcgPjCq6MCXrJA27NVQK2qTJdmjWMv_jtBH1KiGFaN506fowke53jm1IoNCSP0haRdPEgG1efl0rAF2JNra075Vv0ACHXlzOJ4bIVMhX0UjPJO4yaRzmjlvx_ONwj_.png)All custom field blocks have a couple of display settings. Display in Admin will display the field name and value in the donation details page in the backend. Display in Receipt will display the field name and value in the donation receipt displayed on the frontend after a successful donation. ### **Conditional Logic** ![](https://docs.nexcess.com/wp-content/uploads/2026/07/AD_4nXd3RPvB6ZVhCNGOvzi7H0I2oMZivZXcS3l-R_dxCY-AJMrjYc9NW-zw8euEKmCHbKll8PFn8eaa1oRhiA9_JrzKDSnydkVeDl-kS0zEhriwo8neDFrHWeNhugDn-bvknOYcc8pJIgJljSgOSWasM5G2_nQm.png)The “Conditional Logic” option allows you to only display a custom field block based on the value of another field on the form. ### **Advanced** ![](https://docs.nexcess.com/wp-content/uploads/2026/07/AD_4nXevbnbSObRKxZcPxWnYdDTAtudFbjl7Fi_MZ0MWCXusm0_OeVN9obCXk8PIGFsgdN4mckNJgPzNItKyXsopcqSYnjGt7GqZMwOjmFu0eAhKgb4CWPO8rJihtrWfD49-vejs1-3n27EOcgYqGmdwElRyYyNJ.png)Some custom field blocks allow you to assign a default value. The meta key will be the meta key name stored in the database. This is created automatically based on the custom field label. You can edit it if needed. The email tag is automatically created based on the meta key. It’s useful to output the custom field value in the GiveWP emails. By default, all custom field values are stored in the donation record but sometimes you might want to save some of those fields to the donor record instead. Enable the “Save to Donor Record” to do that. ## The Form Field Manager Fields for Options Based Forms The following fields are included within FFM by default. Click on a field to jump to that field: ![](https://docs.nexcess.com/wp-content/uploads/2026/06/Screenshot-2022-12-16-at-2.15.35-PM-1-439x1024-1.png)List of Form Fields- [Text](#text-field) - [Hidden](#hidden-field) - [Textarea](#textarea-field) - [Dropdown](#dropdown-field) - [Date](#date-field) - [Radio](#radio-field) - [Checkbox](#checkbox-field) - [Email](#email-field) - [Phone](#phone-field) - [File Upload](#fileupload-field) - [URL](#url-field) - [Multi Select](#multiselect-field) - [Repeat Field](#repeater-field) - [HTML](#html-field) - [Section](#section-field) - [Do Action](#doaction-field) Each form field can be added to the fieldset and then drag-and-dropped into a particular order. Now, let’s review each field more in depth: --- ### Text Field ![](https://docs.nexcess.com/wp-content/uploads/2026/06/Screenshot-2022-12-16-at-2.16.44-PM-676x1024-1.png)Text field admin viewThe text field is a simple form field type that adds a plain text input to your form. This can be used for many reasons and is typically the most common field you see used within forms. --- ### Hidden Field ![](https://docs.nexcess.com/wp-content/uploads/2026/06/Screenshot-2022-12-16-at-2.25.22-PM-1024x596-1.png)Hidden field admin viewThe Hidden field can be used to store information that should be not visible to the donor but can be processed and stored when the donor makes a donation --- ### Textarea Field ![](https://docs.nexcess.com/wp-content/uploads/2026/06/Screenshot-2022-12-16-at-2.26.42-PM-605x1024-1.png)The Textarea Field Admin View![](https://docs.nexcess.com/wp-content/uploads/2026/06/ffm-textarea-field-plain.png)The Textarea Field Frontend ViewThe text field is a simple form field type that adds a textarea field to your donation forms. Typically, textareas are used to collect large amounts of textual information such as comments or messages. You can control the size of the *normal* textarea using the “Size” and “Columns” values within the admin options. Please note that this does not affect the rich text editors and your theme may have overridden this setting with CSS. --- ## Dropdown Field ![](https://docs.nexcess.com/wp-content/uploads/2026/06/Screenshot-2022-12-16-at-2.30.09-PM-621x1024-1.png)Dropdown field admin view![Select field frontend view](https://docs.nexcess.com/wp-content/uploads/2026/06/ffm-select-frontend.png)Dropdown field frontend viewThe dropdown field is typically used to present a menu of pre-chosen options to the donor. For instance, in the screenshots above you can see we are using the select field to present the user with meal choices. The dropdown field is also commonly referred to as a “select” field. Donors can only select *one* option from the select field. To allow the user to select multiple options please refer to the Multi Select or Multi Check fields. --- ## Date Field ![](https://docs.nexcess.com/wp-content/uploads/2026/06/Screenshot-2022-12-16-at-2.31.35-PM-674x1024-1.png)The Date Field Admin View![](https://docs.nexcess.com/wp-content/uploads/2026/06/ffm-date-field-frontend.png)The Date Field Frontend View![The Date Field on Frontend with Time Picker Enabled](https://docs.nexcess.com/wp-content/uploads/2026/06/ffm-date-field-frontend-timepicker.png)The Date Field on Frontend with Time Picker EnabledThe date field is a powerful field for capturing dates and times for various reasons. The calendar outputs a Gregorian calendar that utilizes the jQuery UI. Above, we have given an example of “Arrival date”, but this can be used for multitudes of other scenarios. **Date Formatting** For a full list of the possible formats, see the [formatDate](http://api.jqueryui.com/datepicker/#utility-formatDate) function. **Powerful Time Picker** The time picker checkbox adds time picker functionality to the date field. This allows the donor to attach a time to to the specific date. --- ## Radio Field ![](https://docs.nexcess.com/wp-content/uploads/2026/06/Screenshot-2022-12-16-at-2.32.33-PM-566x1024-1.png)The Radio Field on the Admin![](https://docs.nexcess.com/wp-content/uploads/2026/06/ffm-radio-field-frontend.png)The Radio Field on the FrontendThe Radio Field allows you to create a set of radio input options that when presented on to the user will give them list of options to choose from. Only one radio may be selected at a time. You may choose which radio field is set by default by clicking the radio next to that item in the admin panel. --- ## Checkbox Field ![](https://docs.nexcess.com/wp-content/uploads/2026/06/Screenshot-2022-12-16-at-2.33.44-PM-591x1024-1.png)The Checkbox field admin view![](https://docs.nexcess.com/wp-content/uploads/2026/06/ffm-checkbox-frontend.png)The Checkbox field frontend viewThe checkbox field is useful for creating a multiple choice list of options for donors to complete. When you require this field they have to choose at least one selection. If you want to limit the user to only one selection, consider using a select or radio list. --- ## Email Field ![](https://docs.nexcess.com/wp-content/uploads/2026/06/Screenshot-2022-12-16-at-2.34.36-PM-678x1024-1.png)The Email Address Field Admin View![](https://docs.nexcess.com/wp-content/uploads/2026/06/ffm-email-frontend.png)The Email Address Field Frontend ViewThe Email field is helpful for collecting more than just the donor’s email address. This field will only accept a valid email address. --- ## Phone Field ![](https://docs.nexcess.com/wp-content/uploads/2026/06/Screenshot-2022-12-16-at-2.36.11-PM-678x1024-1.png)Admin phone field view![](https://docs.nexcess.com/wp-content/uploads/2026/06/front-end-phone-300x37-1.png)Front-end phone field viewIf you would like to give your donors a place to put their phone numbers, use a Phone Field. Take note that you can make the field formatted “(###) ###-###” or unformatted “###-###-####” if you like. Utilize the placeholder text to give your donors direction when they are inputting their number. --- ## File Upload Field ![](https://docs.nexcess.com/wp-content/uploads/2026/06/Screenshot-2022-12-16-at-2.37.19-PM-480x1024-1.png)The File Upload Field Admin View![](https://docs.nexcess.com/wp-content/uploads/2026/06/ffm-upload-frontend.png)The File Upload Field Frontend ViewPerhaps you want your users to provide you with a PDF, CSV, Word Doc, or heck… maybe even an MP3 of them singing. That’s all possible with the File Upload Field. **Restrict Uploads by File Type** By default, the File Upload Field is set to only allow images and PDF file uploads. Check the boxes next to the file types you would like to allow to enable additional file types. Allowed file types are: - Images (jpg, jpeg, gif, png, bmp) - Audio (mp3, wav, ogg, wma, mka, m4a, ra, mid, midi) - Videos (avi, divx, flv, mov, ogv, mkv, mp4, m4v, divx, mpg, mpeg, mpe) - PDF (pdf) - Office Documents (doc, ppt, pps, xls, mdb, docx, xlsx, pptx, odt, odp, ods, odg, odc, odb, odf, rtf, txt) - Zip Archives (zip, gz, gzip, rar, 7z) - Executable Files (exe) - CSV (csv) **Allow More than One File Upload** Another cool feature of this field is the ability to set the number of files you allow to be uploaded at a time. By default, this is set to one but you can adjust this to any number. Bear in mind, if you allow a large number of files (or large file sizes) to be uploaded you will need to take into account the storage of those files and any bandwidth requirements. --- ## URL Field ![](https://docs.nexcess.com/wp-content/uploads/2026/06/Screenshot-2022-12-16-at-2.39.53-PM-676x1024-1.png)The URL Field Admin View![](https://docs.nexcess.com/wp-content/uploads/2026/06/ffm-url-frontend.png)The URL Field Frontend ViewThe URL Field is handy for accepting website addresses in a form field. It will only validate against valid domain names. So, if you’re looking to ask for a website address use this bad boy. It’s probably a good idea to leave it invalid unless it’s absolutely required the user provide a website address in order to donate. Most folks don’t have websites, sadly… --- ## Multiselect Field ![](https://docs.nexcess.com/wp-content/uploads/2026/06/Screenshot-2022-12-16-at-2.40.53-PM-595x1024-1.png)Multi Select Field Admin View![](https://docs.nexcess.com/wp-content/uploads/2026/06/ffm-multi-select-frontend.png)Multi Select Field Frontend ViewThe Multi Select fields is a great way to provide donors a list of options to choose from. They can select one or multiple items. If the field is required, the donor is required to choose at least one option. There are no limits on the number of options you create. --- ## Repeater Field ![](https://docs.nexcess.com/wp-content/uploads/2026/06/Screenshot-2022-12-16-at-2.41.59-PM-575x1024-1.png)Repeater Field Admin View (non-multi column)![](https://docs.nexcess.com/wp-content/uploads/2026/06/ffm-repeater-frontend.png)Repeater Field Frontend View (non-multi column)The Repeater Field allows your donors to enter an unlimited number of entries for a field. In the example above, we have utilized the repeater field to ask for “Guest Names”. This field is handy for requesting information from donors when you don’t know the exact number of entries required. For instance, one donor could have more guests than another. Below you will see a more advanced configuration which uses the “multi-column” feature of the Repeater Field: ![](https://docs.nexcess.com/wp-content/uploads/2026/06/Screenshot-2022-12-16-at-2.42.50-PM-530x1024-1.png)Repeater Field Admin View (multi-column enabled)![Repeater Field Frontend View (multi-column enabled)](https://docs.nexcess.com/wp-content/uploads/2026/06/ffm-repeater-frontend-2.png)Repeater Field Frontend View (multi-column enabled)When the Multi-column option is enabled you can add an unlimited number columns to collect donor data. Piggybacking off the example above, you’ll see we expanded the “Guest Information” repeat field to now ask for more than just a guest’s name. You see we’re collecting additional information such as location, and relationship. If we wanted to, we could add even more columns if we wanted to collect additional information. --- ## HTML Field ![](https://docs.nexcess.com/wp-content/uploads/2026/06/Screenshot-2022-12-16-at-2.44.00-PM-772x1024-1.png)HTML Field Admin View![](https://docs.nexcess.com/wp-content/uploads/2026/06/ffm-html-frontend.png)HTML Field Frontend ViewThe HTML field is for those who know a bit of code. This field allows you to output any type of HTML/CSS markup such as text, images, lists, tables, and inline styles (CSS) and JavaScript. It’s also great for adding a quick message like we have done in the example above. In this example, we have a form accepting donations for our local cat shelter. To tell people their donations go straight to these cute little creatures we’ve added an HTML field with an adorable picture to our form using the HTML field. Note: the title field element is only for admin field reference and will not be output on the frontend. --- ## Section Field ![](https://docs.nexcess.com/wp-content/uploads/2026/06/Screenshot-2022-12-16-at-2.45.01-PM-993x1024-1.png)Section Field Admin View![](https://docs.nexcess.com/wp-content/uploads/2026/06/ffm-section-frontend.png)Section Field Frontend ViewThe section field is used to break up your various form fields. The field outputs a heading that matches the markup of GiveWP’s Core. The styles will adopt the same as the native GiveWP donation form. If you have many fields, it can be easier for donors to understand and complete the donation form if they are broken up into various sections. --- ## Do Action Field ![](https://docs.nexcess.com/wp-content/uploads/2026/06/Screenshot-2022-12-16-at-2.45.58-PM-1024x966-1.png)Do Action FieldThe Do Action field is for developers to add their own custom [WordPress actions](https://codex.wordpress.org/Plugin_API/Action_Reference) to Give donation forms. You can hook your own functions to this action and are provided 3 parameters: `$form_id`, `$post_id`, and `$form_settings`. This field can really be helpful for developers looking to take GiveWP above and beyond.