Custom Field Types

At Raisely, we offer 16 different types of fields to help you gather the information you need to run your campaigns successfully. Click into each option to learn about each field type, including its intended usage and recommended default value and placeholder.

Available Field Types

  

Text

This is a standard text-entry field where the user can enter any information they want, usually just one- or two-word responses. This is commonly used to collect unique information that doesn't need to be in a standardised format, such as names or "Other" values:

Recommended Default Value?
None/Field-specific. Whatever information you enter as a default value here will be treated as user-entered data unless the user overwrites it, so avoid entering a default value you wouldn't want to see on every registrant or donation.

Recommended Placeholder?
Yes, if necessary. Ideally, your users will know what information to provide based on the field's label, but this is a great place to add a helpful hint to your users if you think there might be confusion. 

Unlike default values, placeholder text does not count as content-- if the field isn't required and a user submits the form without entering their own information, the field will be blank in your reports. If the field is required, the user won't be able to submit the form until their information is added.
   

Back to top

    

  

Textarea

This is a standard text-entry field like the Text field, but unlike the Text field it encourages the user to give longer answers. This is commonly used to collect longer bits of unique information, like profile descriptions or donation messages, that don't need to be in a standardised format.

Recommended Default Value?
Yes/Field-specific. It's a great idea to add a default value to "Why are you fundraising?" profile description fields. Profiles without a description tend to look empty and incomplete, and adding a default value here lets your users complete the signup process quickly and easily, and they can edit the content later in the Edit Profile section of their account.

Whatever information you enter as a default value here will be treated as user-entered data unless the user overwrites it, so avoid entering a default value you wouldn't want to see on every registrant or donation.

Recommended Placeholder?
Yes, if necessary. If you choose not to add a default value but still want to encourage thoughtful responses from your supporters, it can be helpful to start with a small prompt to get them started:

Unlike default values, placeholder text does not count as content-- if the field isn't required and a user submits the form without entering their own information, the field will be blank in your reports. If the field is required, the user won't be able to submit the form until their information is added.
   

Back to top

    

    

HTML

This is an advanced field that lets your users enter their own HTML code, and it should only be used by users with previous programming experience. For security purposes, only the following tags are allowed:

<code>    'div', 'p', 'img', 'pre', 'br', 'hr',<br>    'b', 'i', 'em', 'strong', 'a', 'code',<br>    'h1', 'h2', 'h3', 'h4', 'h5', 'h6',<br>    'ul', 'ol', 'li', 'font', 'center', 'style',<br>    'table', 'thead', 'tbody', 'tr', 'td'

Note: Raisely is unable to assist with custom code debugging.
   
Back to top

   

    

Email

This is a text-entry field that checks the user's submission to make sure it includes an @ symbol and .xxx suffix, and to make sure it doesn't contain any spaces.

Recommended Default Value?

None.

Recommended Placeholder?
None.
   

Back to top

 

 

Number

This is an integer-entry field that lets the user enter numbers, periods, and the letter e. It's commonly used to ask supporters how many [thing]s they will need or for their postcode.

Recommended Default Value?
None.

Recommended Placeholder?
None.
   

Back to top

 

  

Phone Number

This is an integer-entry field that lets the user select their country and enter their phone number. It automatically adds the user's selected country code to their phone number in your reports, and a default country can be selected if desired (the user can always change the country if they need).

Recommended Default Value?
None.

Recommended Placeholder?
None.
    

Back to top

    

   

Date

This is an integer-entry field that lets the user enter a date numerically or select a date from a calendar.

  

Minimum Date

This optional field lets you determine the earliest date a user can choose. For example, if you set the minimum date as 17/02/2020, the user can only choose dates on or after February 17th, 2020:

    

Maximum Date

This optional field lets you determine the latest date a user can choose. For example, if you set the maximum date as 17/02/2020, the user can only choose dates on or before February 17th, 2020:

 
Minimum Date + Maximum Date
These two fields can be combined to form a date range of availability. For example, if you set the minimum date as 17/02/2020 and the maximum date as 27/02/2020, the user will only be able to select a date between February 17th-27th, 2020, inclusive:

  

Date Format

Dates are formatted DD/MM/YYYY by default, but you can change the format as you see fit. See the available formats at date-fns.org.
  

Recommended Default Value?

None.

Recommended Placeholder?

N/A.
   

Back to top

      

    

Checkbox

This field asks the user a yes/no question and returns a value of true  (if the user ticked the box) or false (if the user left the box unticked) in your reports. This is commonly used to ask users to agree to an organisation's terms & conditions, or to ask users for permission to send them newsletters.

Note: if this field is marked as Required, the user will be unable to progress in the form unless the box is ticked. This is useful for requiring agreement to T&Cs, for example.

Recommended Default Value?

If you want the checkbox to be ticked by default, enter true as the default value. If you want it to be unticked by default (as shown in the picture above), leave the default value field blank.

Recommended Placeholder?

N/A.
   

Back to top

    

    

Select Items

This dropdown field lets users choose one of several options. This is commonly used to ask users to select an event they want to participate in or for their T-Shirt size. To create the options, start by clicking the purple "Add an option" button:

The following field will appear. There are two required parts to this field: a value and a label:

The value is the information that will be shown on your reports and used to create conditions in your messages and form fields. This is an internal field that will only be seen by your organisation, and it's common to make this an abbreviated form of the public-facing label.
 
The label is the name of the option that your users will see. It's best to make this relatively short to prevent the dropdown options from looking awkwardly big.

To add more options, click the purple circle with the plus sign. To remove an option, click the red circle with the minus sign.

Here is an example of how to offer users a choice of small, medium, or large shirts:

This is how the dropdown will appear to your supporters:

And this is how the data will appear on your reports:

Note: to pull a report containing information from custom fields, you'll need to create a custom report.
  

Recommended Default Value?

Yes-- select an option that is relevant to your campaign. If no default value is selected and the field is not required, it's possible for the user to submit the form without entering any data and this field will be blank in your reports.

Recommended Placeholder?

N/A.

🚨If no value is entered into the option fields, the field will not collect data and your reports will be blank! Make sure to enter both a value and a label. 🚨
   
Back to top

    

    

Country Select

This dropdown field lets the user select one of 300+ countries. The full name of the country will be listed in the dropdown menu, but only the chosen country's 3-letter country code will show on your reports.
  

Recommended Default Value?

Yes-- select an option that is relevant to your campaign. If no default value is selected and the field is not required, it's possible for the user to submit the form without entering any data and this field will be blank in your reports.

Recommended Placeholder?

N/A.
  

Back to top

    

    

Currency Select

This dropdown field lets the user select one of 130+ currencies. The full name of the currency will show on the dropdown menu, but only the chosen currency's 3-letter abbreviation will show on your reports. This field is commonly used on the signup form to ask participants in which currency they want to fundraise.

Recommended Default Value?

Campaign-specific/if desired. If no default value is chosen, the field will default to the campaign's currency.

Recommended Placeholder?

N/A.
  

Back to top

    

    

Currency

This is an integer-entry field that lets the user enter numbers, periods, and the letter e, and it is prefixed with the currency symbol of the organisation-selected currency. It's commonly used on the signup form to ask supporters for their fundraising goal.

Amount Minimum

This optional field lets you determine the smallest number or amount a user can submit. The currency can be changed by clicking the three-letter abbreviation and choosing the desired currency from the dropdown list. The currency is set at the organisation level and cannot be changed per campaign.

Amount Maximum

This optional field lets you determine the largest number or amount a user can submit. The currency can be changed by clicking the three-letter abbreviation and choosing the desired currency from the dropdown list. The currency is set at the organisation level and cannot be changed per campaign.

Amount Minimum + Amount Maximum

These two fields can be combined to give the user a specific range of allowed values. In the examples above, the participant was only allowed to enter a value greater than $200 but less than $500.

Note: It is not possible to mix currencies here. Changing the currency on either the amount minimum or amount maximum fields will always change both fields.
   
   

Recommended Default Value?

We recommend adding a reasonable 'reach' figure here to encourage participants to raise as much as they can without feeling intimidated.

Recommended Placeholder?

A placeholder figure can be used instead of a default value if desired. Unlike default values, placeholder text does not count as content-- if the field isn't required and a user submits the form without entering their own information, the field will be blank in your reports. If the field is required, the user won't be able to submit the form until their information is added.
  

Back to top

    

    

File Upload

This field asks the user to upload a file, and it is commonly used to ask users to add a profile picture. Accepted file types include BMP, JPG, PNG, and TIFF, and the file must be 20MB or smaller.

Field Format
This dropdown lets you choose between two options: Full Width and Square. Choose Full Width if you want your users to upload a large, full-screen width picture (like a hero or background image). Choose Square if you want your users to upload a profile picture or similar.
    

Recommended Default Value?

N/A. To set a default profile picture, add your image within your campaign by going to Design > Brand > Default Profile Image.

Recommended Placeholder?

N/A.

Recommended Dimensions?

With over 30 different themes, and infinitely customisable pages, it's difficult to make dimension recommendations that will suit every purpose and every campaign's unique needs. Below is a list of dimensions we've found often work best, and we'll update it as we discover more:

Banner/header images: 2000px width, variable height
Profile pictures: 600px by 600px, minimum 300px by 300px
  

Back to top

    

    

Address Lookup

This dynamic field uses Google to search for a user's address as they type. If the user's address cannot be found, they can click the "Or enter your address manually" link to reveal text fields where they can enter their information.

While using Google search:

Entering address manually:

Note: AddressFinder is available to interested AU/NZ organisations.
Contact us for more information.
   
Back to top

    

    

Heading

This static field helps visually segment your form and keeps it looking clean. It's generally used as a title to define different sections of your form.

   

Back to top

    

    

Description

This static, multi-purpose field is used to provide additional information about a topic. It's commonly used to further explain a Heading (instead of using help text).

Note: this field can be formatted with HTML if desired.
   

Back to top

 
 
 
  

Have questions? Contact us!

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us