Form builder block reference

The form builder includes 34 blocks organized into five categories: Donation amount, Donor information, Custom fields, Content & layout, and Extras. This page covers every block, its purpose, and its key settings.

Donation amount blocks

These blocks handle the money side of the form: the amount, the frequency, fees, currency, and how the donor pays.

Block	Description
Donation amount	Lets donors select or enter a donation amount
Recurring toggle	Lets donors choose a recurring frequency
Cover the fees	Lets donors opt in to cover processing fees
Currency switcher	Lets donors switch between currencies
Payment gateways	Displays available payment methods

Donation amount

Lets donors select from preset tiers or enter a custom amount. This is a required block — every form must include it.

Setting	Description	Default
Donation type	Multi-level shows preset tiles donors pick from. Open amount drops the tiles and lets donors enter any amount	`Multi-level`
Options	The preset amounts. Each has an amount, an optional caption, and a radio that marks it as preselected. Reorder them by dragging	10, 25, 50, 100
Allow custom amount	Let donors type an amount of their own alongside the tiles	`On`

Configure preset amounts with captions (for example, “Feeds a family for a week”) to guide donors toward specific amounts.

Recurring toggle

Lets donors choose whether to make a one-time or recurring donation, and select a frequency.

Setting	Description	Default
Style	Display the choices as pills or tabs	`Pills`
Allowed frequencies	Which frequencies donors can pick	One-time, Monthly
Default selection	The frequency pre-selected when the form loads	`One-time`
Label	Text shown above the selector	—
Help text	A line of guidance under the selector	—

Use this block when your organization accepts recurring donations. Place it near the Donation amount block so donors see both options together.

The block needs at least two frequencies to render. With one or none it is silently hidden on the published form, and the pre-launch checks in the editor warn you about it.

Cover the fees

Gives donors the option to add a small amount to cover payment processing fees.

Setting	Description	Default
Percent fee	Percentage of the donation to add	`2.9`
Fixed fee	Flat amount added on top, entered in your currency	`0.30`
Default checked	Whether the checkbox is ticked when the form loads	`Off`

Edit the checkbox label directly on the canvas. The fee is calculated as (donation amount x percent) + fixed amount. Leaving Default checked off means donors opt in deliberately.

Currency switcher

Lets donors switch between different currencies on the form.

Setting	Description	Default
Currencies	Which of your enabled currencies this form offers. Your base currency is always included	Base currency only
Style	Display as a dropdown or as pills	`Dropdown`
Label	Label text for the switcher	—
Alignment	Left or right	`Left`

You can only offer currencies you have enabled under GiveFlow, then Settings, then Currency.

Payment gateways

Displays the available payment methods so donors can choose how to pay.

Setting	Description	Default
Gateway toggles	One toggle per gateway. Switch off the ones this form should not offer	All on
Description (optional)	Custom description text shown under each gateway	—
Style	Display as cards or as a compact list	`Cards`

Use this block when you have multiple payment gateways enabled and want donors to pick their preferred method. The block hides itself when only one gateway applies.

While this block is on the form, it owns the gateway list. The gateway checkboxes in the form settings are disabled and you set the allowed gateways here instead.

Donor information blocks

These blocks collect information about the donor. Name and Email are required on every form.

Block	Description
Name	Collects first and last name (required)
Email	Collects email address (required)
Phone	Collects phone number
Address	Collects full postal address
Country	Collects country selection

Name

Collects the donor’s first and last name. This is a required block — every form must include it.

Setting	Description	Default
First name label	Label for the first name field	—
First name placeholder	Placeholder text for the first name field	—
First name required	Whether the first name field is required	`On`
Last name label	Label for the last name field	—
Last name placeholder	Placeholder text for the last name field	—
Last name required	Whether the last name field is required	`On`

Email

Collects the donor’s email address. This is a required block — every form must include it.

Setting	Description	Default
Label	Label for the email field	—
Placeholder	Placeholder text	—

There is no required toggle on this block. A donation always needs an email address, so the field is always required.

Phone

Collects the donor’s phone number.

Setting	Description	Default
Label	Label for the phone field	—
Placeholder	Placeholder text	—
Required	Whether the field is required	`Off`

Use this block when you need to contact donors by phone, such as for major donation follow-ups.

Address

Collects a structured postal address from the donor.

Setting	Description	Default
Heading	Text shown above the address fields	—
Show toggles	Show or hide each part: line 1, line 2, city, state / region, postal code, country	All on
Required toggles	Mark a visible part as required. Every part except line 2 has one	Line 1, city, postal code, and country required
Label overrides	Set your own label on any individual part	—

Use this block when you need the donor’s mailing address for receipts or correspondence.

Country

Displays a country picker for the donor to select their country.

Setting	Description	Default
Label	Label for the field	—
Placeholder	Placeholder text	—
Required	Whether the field is required	`Off`

Use this block when you accept international donations and need to know the donor’s country.

Custom field blocks

These blocks let you collect additional information beyond the standard donor fields.

Most of them have a Field name setting, the key the answer is stored under. Leave it empty and GiveFlow derives one from the label. The Hidden field calls the same setting Field key and has no label to fall back on, so give it one. The Comment block has no field setting at all.

Answers to these fields are shown on the donation’s detail screen under GiveFlow, then Donations, labelled with the block’s label.

Block	Description
Text input	Single-line text field
Number input	Numeric input field
Date	Date picker field
Dropdown	Dropdown select menu
Radio group	Radio button group
Checkbox	Single checkbox field
Multi-select	Multi-option checkbox list
Comment	Lets donors leave a message or note
Hidden field	Hidden field for passing data

Text input

A single-line text field for collecting custom information. Alongside the label, placeholder, help text, and required toggle, you can set a maximum length and a validation pattern.

Use this block for short free-text responses like employer name or membership ID.

Number input

A numeric input field that accepts only numbers. You can set a minimum, a maximum, and a step.

Use this block for collecting quantities, ages, or other non-currency numeric data.

Date

A date picker that lets donors select a date. Minimum date and Maximum date bound the range they can pick from.

Use this block for collecting event dates, birthdays, or dedication dates.

A dropdown select menu with predefined options. Each option has a label, a stored value, and a flag marking it as the default.

Use this block when you have a list of options and donors should pick one. Good for categories like “How did you hear about us?”

Radio group

A radio button group where donors can select one option from a visible list. Options work the same way as the Dropdown block, and you can lay them out vertically or horizontally.

Use this block when you have a small number of options (2-5) that should all be visible at once.

Checkbox

A single checkbox for yes/no responses. You can add help text, mark it required, and have it ticked by default.

Use this block for acknowledgments, agreements, or yes/no questions.

Multi-select

A checkbox list that lets donors choose several options. You can set a minimum and maximum number of selections.

Use this block when donors may need to select more than one option, such as areas of interest.

Comment

Lets donors write a message or note with their donation.

Setting	Description	Default
Label	Label for the field	—
Placeholder	Placeholder text	—
Required	Whether the field is required	`Off`

Use this block when you want to let donors share why they are donating or leave a personal message.

Hidden field

A hidden field that captures a value with the donation without displaying anything to the donor.

Setting	Description	Default
Field key	The column name this value appears under in donation reports. Lowercase, underscores	—
Source	Where the value comes from: a fixed value, a URL query string parameter, one of the five UTM parameters, the referrer URL, or the landing page URL	`Fixed value`
Query parameter name	Which query string parameter to read, when the source is a URL query string	—
Fallback value	Used when the source resolves to empty, for example when the donor arrived directly	—

Use this block to track referral sources, campaign codes, or other metadata donors do not need to see.

Content & layout blocks

These blocks control the visual structure and flow of your form.

Block	Description
Heading	Adds a heading
Paragraph	Adds body text
Divider	Adds a horizontal line
HTML	Adds custom HTML
Section	Groups blocks into a styled container
Row	Arranges fields side by side
Columns	Creates a column layout
Privacy notice	Displays a short notice and your privacy policy link
Steps	Wraps step blocks for multi-step forms
Step	A single step inside a Steps block

Heading

Adds a heading to your form. Set the heading level and alignment. Use it for section titles or to break up long forms.

Paragraph

Adds body text to your form. Use it for instructions, descriptions, or context between fields.

Divider

Adds a horizontal line to visually separate sections of your form. You can set the space above, the space below, the line thickness, and the line color.

HTML

Lets you insert custom HTML into your form. Scripts and embeds are stripped.

Section

A styled container for headings and copy, with its own background, text color, border, shadow, padding, margin, and minimum height. Use it for hero areas, impact statements, or intro blurbs.

Row

Arranges fields side by side, in 1 to 4 columns with an adjustable gap. Use it to place fields like first name and last name next to each other.

Columns

Lays out content blocks in a grid, in 1 to 6 columns with an adjustable gap. Use it for wider layouts than the Row block is meant for.

Privacy notice

Shows a short line of text with a link to your privacy policy.

Setting	Description	Default
Leading text	The notice shown to the donor	—
Link label	The wording of the privacy policy link	—
Alignment	Left, center, or right	`Left`

The link points at the privacy policy URL set under GiveFlow, then Settings, then Privacy. When no URL is set there, the notice renders without a link. This block does not collect anything; use the Consent block for that.

Steps

Wraps Step blocks to create a multi-step form. A form can hold one Steps block, and it arrives with two steps already inside. See Multi-step donation forms for details.

Setting	Description	Default
Progress style	Display progress as dots, a bar, or none	`Dots`
Back-button label	Text for the back button	`Back`
Next-button label	Text for the continue button	`Continue`

Step

Represents a single page inside a Steps block. You cannot insert one from the block inserter; use the + Add step button on the Steps block.

Setting	Description	Default
Label	The name of this step	—
Show label	Whether to display the label above the step content	`On`

Extras

These blocks add optional elements to the form, plus the button that completes the donation.

Block	Description
Goal	Shows a progress bar toward a fundraising goal
Fund picker	Lets donors choose which fund receives their donation
Anonymous toggle	Lets donors give anonymously
Consent	Collects consent for specified purposes
Donate button	The button that completes the donation

Goal

Displays a progress bar showing how close a goal is to being reached.

Setting	Description	Default
Show	Track the parent campaign’s goal, or this form’s own goal	`Campaign goal`
Show amount raised vs goal	Display the running total against the target above the bar	`On`
Show donor count	Display the number of donors alongside the percentage	`On`
Show deadline	Display the days left, when the campaign has an end date. Campaign goal only	`Off`

Use this block to create urgency and show donors the impact of their donation. Set the form’s own goal in the form settings; set the campaign goal on the campaign.

Fund picker

Lets donors choose which fund or program their donation supports. Funds appear as selectable tiles, with parent funds acting as non-selectable group headers.

Setting	Description	Default
Label	Heading shown above the tiles	—
Preselected fund	The fund selected when the form loads. Leave it on the first entry to follow the form, campaign, then organization default order	—
Restrict to funds	Which funds this block offers. Leave all unchecked to show every active fund	All active funds
Allow “no specific fund”	Adds a tile letting donors skip choosing a fund	`Off`
No-specific-fund label	Wording on that tile	`No specific fund`
No-specific-fund description	Optional line under that tile’s label	—

Fund names and descriptions come from the funds themselves, which you manage under GiveFlow, then Funds.

Anonymous toggle

Lets donors choose to make their donation anonymous.

Setting	Description	Default
Default on	Whether the toggle is on when the form loads	`Off`

Edit the label directly on the canvas. Use this block to give donors the option to hide their name from public donor lists.

Collects explicit consent from donors for specified purposes, such as email newsletters or data processing.

Setting	Description	Default
Heading	Text shown above the consent checkboxes	—
Help text	A line of guidance under the checkboxes	—
Default state	Opt-in leaves the boxes unticked; opt-out ticks them	`Opt-in`
Purposes	The list of consent purposes. Each has an ID, a label, an optional description, and a “Required by law” flag that forces it on and shows a Required pill	Email me about future campaigns

The purposes are set on the block itself. Use this block to comply with privacy regulations or to collect marketing consent.

Donate button

The button donors click to complete their donation.

Setting	Description	Default
Alignment	Left, center, right, or full width	`Left`
Show donation summary	Shows the donor a summary of amount, fees, and total just above the button	`On`

Edit the button text directly on the canvas. It reads “Donate now” until you change it.