Skip to main content

[Donation Forms] Custom Fields

Updated over 2 weeks ago

Custom fields can be added to your donation forms to capture information that isn’t requested in a system or billing field. You can even use conditional logic to only show certain custom fields under specific conditions.

Looking for information on system and billing fields? You can find that here.

Contents:

Introduction and Field Types

To set up custom fields, head to the Custom Fields tab within the Fields menu in your Form Settings.

Custom Field navigation.png

Custom fields come in a variety of formats so you can collect various types of information. Your options include:

  • Checkbox

  • Date

  • Dropdown

  • Email Address

  • Multiple Selection

  • Number

  • Paragraph Text

  • Phone Number

  • Radio Button

  • Short Text

  • Website

  • Hidden Field

    • These can be used to pass along a hidden value of your choosing whenever a form is submitted. For more information, check out our Hidden Fields FAQ.

Here's a look at how each field type will display on your form:

Checkbox

checkbox.png

Date

When a donor clicks in the field, a calendar will appear so they can pick a date.

datefield.png

Dropdown

dropdown.png

Email Address

If a donor enters text that is not validated as an email address, they'll receive an error message asking them to enter a valid email.

emailfield.png

Multiple Selection

multiple-selection.png

Number

Field validation prevents any characters that aren't numbers from being entered in this type of field.

numberfield.png

Paragraph Text

This field includes a character limit option.

paragraph-text.png

Phone Number

Area code formatting will automatically be applied when a 10-digit phone number is entered.

phonenumberfield.png

Radio Button

radio-button.png

Short Text

This field includes a character limit option.

short-text.png

Website

If a donor enters text that is not validated as a website, they'll receive an error message asking them to enter a valid website address.

website.png

Hidden Field

Just kidding, these won't show up on your public-facing form. :)

Adding a Custom Field

To create a new custom field click the Add New Field button above the custom fields table. An area will appear where you can enter the details of your new custom field.

Custom_Fields_Full_View.jpg

Select the Field Type you’d like to add from the drop-down menu.

Field_Type_dropdown.png

Depending on the type of field you select, your configuration options may look slightly different. For example, if you add a drop-down menu, you’ll see an area for entering multiple options that will appear in your drop-down.

Next, enter a Field Label. The text you enter here is what will show up on your form. You can also enter an optional Field Help Text if you need to provide context for your donors.

Custom_Fields_Help_Text.jpg

There is a 60-character limit for field labels of certain field types. These include:

  • Short Text input

  • Paragraph Text input

  • Dropdown input

Any custom field of this type that you create will be subject to the character limit.

Next, determine if this field should be required or not. You can also make a field required based on a custom donation amount, as shown below.

05_Required.png

Next, you’ll configure your display settings for the field and, if you want, enable conditional logic.

Adding Conditional Logic and Configuring Display Settings

If you’d like to gather more information based on a donor’s response to a custom field, you can enable conditional logic! Adding conditional logic means the field will only be displayed if donors take a certain action in a previous field.

Please note: In order to link two custom fields together with conditional logic, you must create the first field in the set, and then create the field which you'd like to have appear based on the donor's response to the first field.

For example:

  • First, create a field asking donors "Are you interested in volunteering?" Save the field.

  • Next, create a field you'd like to appear based on the answer to "Are you interested in volunteering?" For example, you could create a field for "What areas interest you?" and provide options for donors to choose from.

  • Then, apply conditional logic to the field that will appear using the steps below.

Click the Enable Conditional Logic toggle.

06_Conditional.png

Choose a condition from the Only show if drop-down menu that appears beneath the conditional logic toggle. Conditional logic can be set based on three different criteria:

  • A custom field response

  • Donation Amount

  • Donation Type

07_ConditionalYES.png

With this logic applied, if a donor answers “yes” to “Are you interested in volunteering?”, then the custom field asking “What areas interest you?” will appear. Here’s what that looks like on the front end:

Donor sees the first custom field question:

08_Interested.png

If the donor answers “yes,” the field with conditional logic applied displays:

09_YES.png

You can also make a field conditional based on the donation amount.

10_DonationAmount.png

Determine whether you want the field to display based on gifts being less than, equal to, or greater than a set dollar amount. Then enter the donation amount in the text field. The field will now only display when the conditions you’ve set are met.

Your third option is to set conditional logic based on donation type.

11_DonationType.png

If using Donation Type for conditional logic, choose whether to display for one-time donations or recurring donations.

Display Settings

Once you’ve configured (or skipped) conditional logic, choose where on your form to display the custom field. You have two options.

  • Display the custom field in Donor Details

  • Display the custom field in Additional Details (adds a step to your form)

12_DisplayWhere.png

Then, choose the device/service options for where your custom field will appear. You can make multiple selections. The field can appear:

  • On the Desktop version of your form

  • On the Mobile version of your form

  • In the Virtual Terminal (when manually entering gifts)

  • On your mobile form for Text-to-Donate (if you’re using Text Fundraising)

13-Displayoptions.png

Finally, review your Reporting Settings.

The Reporting Label is created based on the Custom Field Label, but you can edit it. This will be used as the column header for this custom field in all reports. Use the underscore instead of spaces.

New field Reporting Settings.png

When you’re satisfied with your field settings, click Add New Custom Field. Your new field will then be added to your list of custom fields.

From this list, you can toggle the custom field on or off and review where the custom field is being displayed, what type of custom field it is, and whether it’s required.

15-listofFields.png

A Note on Field Security

When creating a custom field, make sure you’re not asking for sensitive information, such as credit card numbers, Social Security numbers, Tax Payer IDs, protected health data, and so on.

Custom fields are not set up to securely collect and store sensitive data, and using them in this way is a violation of our Terms of Service. If you attempt to set up a custom field to collect sensitive information, you may see an error message that prevents the field’s creation.

Adding a Field Group

Custom fields can also be grouped together into Custom Field Groups. A group of fields will always appear together on a form. You can toggle fields within a group on and off with the press of a button. Custom field groups are editable, and the group itself can use conditional logic.

Please note: Individual custom field settings are overridden by group settings.

Field_Group.jpg

To create a new Custom Field Group, select the Add New Field Group button above the custom field table.

17_AddFieldGroup.png

An area will appear where you can set up your new custom field group.

18_FieldGroupUI.png

First, enter a Group Name.

19_GroupName.png

Select custom fields you've already created to add to the custom field group using the Fields drop-down menu.

fields-dropdown.png

Decide if you want all selected fields to be shown on separate lines.

separeatelines.png

Next, set the Display Settings.

21_DisplaySettings.png

Like custom fields, custom field groups can use conditional logic, which we covered earlier.

When satisfied with your custom field group settings, click Add New Custom Field Group. Your group will now be displayed on your donation form.

Please note: If you ever want to delete a field group, you'll need to delete or remove each field in the group first.

Did this answer your question?