Use this link to share with your colleagues:
How to Create an Enhanced Donation Form: https://help.pm.leapevent.tech/a/1045742
Enhanced Donation Forms empower you with more flexibility when creating and using your Donation Forms. They allow you to charge donations based on types and numbers of items or tickets purchased.
Because of these features, Enhanced Donation Forms are especially great if you're holding a gala or fundraising event and want your patrons to be able to buy tickets or make reservations online. For example, with a custom quantity field, you can set Gala Tickets at $50 each, so selecting 2 will automatically generate a total of $100.
In this article, we'll walk through the whole process of creating an Enhanced Donation Form. We'll follow an example to create a form for a gala:
- Create a custom Record Type
- Build Enhanced fields that you need
- How to build radio picklist fields
- How to build quantity fields
- How to build currency fields
- How to build the fee offset field
- Create and adjust your Enhanced Donation Form
- Test your work
- Adjust your Gala page layout
- Plus, Frequently Asked Questions
All in all, this should take about 1-4 hours, depending on how many fields you need to create. Ready? Let's go!
Heads up - this can get a bit tricky!
These instructions are intended for Certified PatMan Administrators. Grab your organization's Certified Admin, or, if you're interested in becoming one, check out our Introduction to the PatronManager Admin Certification Program.
1. Create a custom Record Type
Create a Donation Record Type specifically for what you need, if you haven't already. This makes it easy to report on these donations, and to keep fields related to your events from cluttering up regular Donation page layouts.
In this example, we'll create a Record Type for a Gala.
First, let's check to see if we've already built the Gala Record Type.
2. Check to see if a Gala Record Type already exists, and click "Cancel"
3. What did you see?
- If a Gala Record Type already exists, skip to the next step!
- If you didn't see a Gala Record Type in the list, continue on below
7. Name your page layout and click "Save"
- Existing Page Layout: Choose "Donation Layout"
- Page Layout Name: Gala Layout
- Click "Save"
8. Now, go to the Record Types tab
Don't worry about configuring this layout now - we'll do that later after we've created some new fields
10. Fill out the fields and click "Next"
- Existing Record Type: Select "Donation"
- Record Type Label: Gala (Record Type Name auto-populates based on Label)
- Sales Process: Choose "Donations"
- Description: Provide a description of what the record type will be used for to keep your colleagues (and Future You) in the loop
- Active: Check this box
- Enable for Profile: Check all profiles
- Click "Next"
2. Create any Enhanced fields that you need
Now it's time to create our Enhanced Donation Form Fields, like Radio Picklists, Quantity fields, Currency fields, or a Fee Offset checkbox!
You may not need all of these fields, so feel free to jump to the ones that you need.
What's the difference between these different Enhanced Donation Form Fields? Here's a little breakdown for you:
- Radio Picklists allow donors to select one option from many
- Quantity Fields allow donors to select a number of something, like gala tickets, that they would like to pay for via a dropdown list
- Currency Fields allow donors to manually enter an amount
- Fee Offset Checkboxes allow donors to check a box to cover a 3% credit card processing fee, or to leave it unchecked and not cover the fee
First, we'll build a text field on the Donation object in Setup, then we'll build a corresponding Radio Picklist field on the Enhanced Donation Form section in the Donation Forms tab.
In this example, we'll create Donor Level radio picklist field. With this field, anyone purchasing tickets to your fundraising event can also select a Donor Level, which is attached to a contribution level on top of the ticket price.
Why do I have to build these fields in two different places? That's a reasonable question; happy to answer!
Enhanced Donation Form fields are special; they make calculations regular custom fields can't. In order to capture and track the important information Enhanced Donation fields collect, it's necessary to create a corresponding field in setup.
First, let's check to see if this Radio Picklist field already exists.
2.1. Click on the App Launcher - search for and click on Donation Forms
What do you see in the "Existing Enhanced Form Fields" section?
- If the Radio Picklist field you want to build already exists, skip this and move on to the next step.
- If you don't see it, continue here to build it!
2.6. Fill out the field information:
- Field Label: Donor Level
- Length: 150 will do
- Field Name: Auto-populates based on the Field Label
- Description & Help Text: Briefly describe what the field will be used for. Your colleagues and Future You will sing your praises
- Click "Next"
2.8. Uncheck everything except the Gala Layout, and click "Save"
OK, we're half done! Let's go create the corresponding Radio Picklist field in the Donation Forms tab.
2.9. Click on the App Launcher - search for and select Donation Forms
2.11. Name the field, select "Radio Picklist" as the Type, and click Save
In this example, we'll call the field "Donation Level".
2.14. Fill in your first Radio Picklist option
-
Label: Name the level, and include the amount since patrons will see this on the form
- e.g.: "Copper: $100"
- Amount: Define the dollar amount of this level
- Tax-Deductible Amount: include a Tax-Deductible amount for each picklist option.
- Click "Save"
2.16. You're done with your Radio Picklist field! Repeat these steps as necessary
Repeat this section to build additional Radio Picklists. Here are some examples of possible additional Radio Picklists.
- Member Level - if you want to offer membership tiers along with Gala tickets
- Sponsorship Level - if you'd like to solicit sponsorships for the fundraiser on your Enhanced Donation Form
Let's build a Number field on the Donation object in Setup, then we'll build a corresponding Quantity field on the Enhanced Donation form section in the Donation Forms tab.
These quantity fields are great to allow you to sell add-ons where your donor can choose how many they'd like. You'll assign each item a price and the system will add the cost to the total amount.
In this example, we'll create a field called Ticket Quantity; it will capture the number of gala tickets a patrons wants to buy and automatically apply the per-ticket price to the total.
Let's check to see if this "Ticket Quantity" field already exists.
2.1. On the Donation Forms tab, what do you see in the "Existing Enhanced Form Fields" section?
- If a Quantity field already exists, skip this and move on to the next step.
- If you don't see a Quantity field, continue here to build it!
2.4. Fill out the field information:
- Field Label: Give your field a name
- Length & Decimal Places: Keep the default numbers as-is
- Field Name: Auto-populates based on the Field Label
- Description & Help Text: Briefly describe what the field will be used for. Your colleagues and Future You will be so happy you did!
- Click "Next"
2.6. Uncheck all page layouts except Gala Layout, and click "Save"
Halfway there! Now, let's head to the Donation Forms tab.
2.9. Fill in the information for your Quantity field
- Name: Name your field something like "Quantity"
- Type: Select "Quantity Field"
- Unit Amount: Enter the value of one item (e.g., for tickets that cost $150, enter 150.00)
- Unit Tax-Deductible Amount: Enter the tax deductible amount for each item
-
Minimum & Maximum Quantity: How many tickets you want patrons to be able to select, from 1 to as many as you like
- We recommend 10 to keep the list short, but you may want to enter up to 100 for raffle tickets
- Click "Save"
You cannot set a maximum quantity greater than 999, or your donation form will break. Remember: patrons will be selecting the number of things from a dropdown list.
2.10. You're done with your quantity field! Repeat these steps as necessary
Head back up to the top of this section to walk through building more quantity fields.
You might be interested, for example, in a quantity field for raffle tickets. That way, donors can purchase raffle tickets ahead of time.
Let's build a Currency field on the Donation object in Setup, then we'll build a corresponding Currency field on the Enhanced Donation form section in the Donation Forms tab.
In this example, we'll create an Additional Donation field so patrons can donate a little extra on top of their Gala tickets if they wish.
First, let's check to see if this "Additional Donation" field already exists.
2.1. What do you see in the "Existing Enhanced Form Fields" section?
- If the Currency field you need already exists, skip this and move on to the next step.
- If you don't see the Currency field, continue here to build it!
2.6. Fill out the field information:
- Field Label: Give your field a name
- Length: 8
- Decimal Places: 2
- Field Name: Auto-populates based on the Field Label
- Description & Help Text: Briefly describe what the field will be used for. Your colleagues and Future You will sing your praises
- Click "Next"
2.8. Uncheck all page layouts except Gala Layout, and click "Save"
Time to create our corresponding field in the Donation Forms tab!
2.9. Navigate to the App Launcher and select Donation Forms
First, we'll build a Currency field called "Fee Offset Amount" on the Donation object in Setup, then we'll build a corresponding Fee Offset Checkbox field on the Enhanced Donation Form section in the Donation Forms tab.
The Fee Offset Checkbox adds 3% to the total donation amount to offset credit card processing fees.
If your organization doesn't want to ask your patrons to offset the credit card processing fee, no need to build this set of fields; skip down to the next section.
Note: Processing fees vary based on credit card type and sometimes other factors, but 3% usually totally covers the cost of CC fees and helps make up for folks who don’t check the Fee Offset box.
Let's check to see if this "Fee Offset Amount" field already exists.
2.1. What do you see in the "Existing Enhanced Form Fields" section?
- If the "Fee Offset Amount" field already exists, skip this and move on to the next step.
- If you don't see the "Fee Offset Amount" field, continue here to build it!
2.6. Fill out the field information:
- Field Label: Give your field a name
- Length & Decimal Places: Leave these numbers as they are
- Field Name: Auto-populates based on the Field Label
- Description & Help Text: Briefly describe what the field will be used for. Your colleagues and Future You will sing your praises
- Click "Next"
2.9. Navigate to the App Launcher and select Donation Forms
3. Create and adjust a new Donation Form
Now, let's create a new Donation Form to feature our Enhanced Donation Form Fields. We'll create an entirely new Donation Form, and we'll add new and adjust existing fields.
Everything we do here will be familiar to you if you've created a normal donation form before!
3.2. Fill out the top section like this:
- Donation Form Name: name it after the purpose or event you're using it for
- Accept single or recurring donations?: single only
- Active: checked
- Donation Record Type: the custom Record Type you built
- Single Donation Template: we recommend creating a custom donation confirmation template for your gala donation form
- Logo URL: when they click the logo on your form, where should they be redirected?
3.3. We recommend setting a custom confirmation page for your form
After all, this isn't an everyday, normal donation.
3.4. Don't forget to fill out your footer information
Unless you need some special info, you can probably just copy and paste the footer information from one of your regular donation forms.
3.5. ...and your theme
Make your form look totally different than your normal donation form, or keep it consistent with your PTS and regular donation forms - it's up to you!
3.1. On the donation form, scroll down to the form builder section; find the Donation Levels block and click "Del" next to each level
3.4. We're adding the Donation Level field we created wayyy back at the beginning of this article
- Field Name: Donor Level
- Field Type: Donation Level
- Sort Order: we recommend top of the form, something like 6
- Label: Donor Level
- Required: unchecked
- Save!
3.6. Now let's add the Ticket Quantity field we created
- Field Name: Ticket Quantity
- Field Type: Ticket Quantity
- Sort Order: one more than what you set for Donor Level (in this case, 7)
- Label: How many tickets would you like to purchase?
- Required: checked
- Save!
3.8. This time let's add the Additional Donation field we created
- Field Name: Additional Donation
- Field Type: Additional Donation
- Sort Order: 9
- Label: Would you like to add an additional donation?
- Required: unchecked
- Save!
3.10. Time to add the Fee Offset field
- Field Name: Fee Offset Field
- Field Type: Fee Offset
- Sort Order: 10
- Label: Would you like to cover the processing fee for this transaction? (adds 3%)
- Required: unchecked
- Save!
3.12. We're adding a "Total" field - fill out the page like this:
- Field Name: Amount
- Field Type: default
- Sort Order: 12
- Label: Total
- Required: checked
- Save!
3.13. Alright, we're done adding/removing fields!
If you're unsure of how to do any of the below, you can get some pointers from the How to Create/Edit Donation Forms article!
3.1. Change the text on the large header from "Donate" to something more specific and bring it to the top of the page
Edit this standard Large Header block that reads "Donate"...
...to something like this:
- Field Name: Large Header
- Sort Order: 1
- Content: the name of your event
- Save
3.2. Change the small text to something more specific and put it right under the header you just updated
Edit this standard Short Text block that reads "Please complete the form"...
...to something like this:
- Field Name: Short Text
- Sort Order: 2
- Content: the message you'd like to appear at the top of your form
- Save
3.4. Add a constant/default value so donations through this form go to the corresponding gala Campaign
First, grab the ID from your Campaign (it's in the URL):
Then head to your form, find Hidden Fields at the very bottom of the page, and click "New Field":
Fill out the page like this:
- Field Name: Campaign ID
- Default Value: paste in the ID from your Campaign
- Save
3.5. Add another hidden field - Tax-Deductible Amount - so the form can do some math
Click Add Field in the hidden fields section
Now fill the form out like so:
- Field: Tax-Deductible Amount
- Default value: leave blank
- Required: unchecked
- Savey save
3.6. That's it! You've built your form!
Keep reading to test out your form - you want to make sure it works.
4. Test your form!
Once you've added all of your Enhanced Form Fields, click the Public Form URL and see how it looks.
Beautiful! Make selections and watch the Total field increase!
5. Adjust the Gala page layout
And now, a little housekeeping.
All the fields you created in Setup are on the Gala page layout, and you'll need to organize them.
6. You're done!
Frequently Asked Questions - with answers!
No need to reinvent the wheel! You can reuse the Enhanced Donation fields you've already created on future Enhanced Donation Forms.
No, that leads to inaccurate information and data loss.
Let's say you want to create a two radio picklist fields, one for your membership levels and one for an add-on benefit. You'll want to create two radio picklist Enhanced Donation Form Fields, and two fields on the Donation object.
When you use Enhanced Donation fields, you won't need the Donation Levels you see on normal Donation Forms (read: non-Enhanced Donation Forms). Instead, you can create levels with an Enhanced Donation radio picklist field.