In 95% of situations, we suggest using Form V2. Form V1 embeds directly into your website code and therefore allows for more custom configurations—although development knowledge is required to implement these configurations. Form V2 is delivered through an iFrame, provides a better user experience, and allows for more native Funraise features, like Apple Pay or Tickets.
The Form Ids and script links here are for demo purposes only. Be sure to copy the form code directly from your platform and then configure it using the tips below.
If you're only embedding a single form on a single page, you can copy and paste the entire embed code into an HTML block in the body of your webpage.
If you're embedding multiple forms on a single page or across your website, you'll need to separate parts of the embed script and place them in the appropriate places.
Launch the Form with a custom amount by adding
data-amount="" to your button element.
You can prefill some donation and donor information fields on the form.
Set or override the default amount button selected by adding
preSelectButton: 1 to your Form Script. You can select any button: 1,2,3, or 4.
Set a minimum allowed transaction amount with
minAmount: 1 and a maximum allowed transaction amount with
maxAmount: 50000. Enter your desired values.
Your custom button can launch the Donation Form with a frequency preselected. Add
data-frequency="" to your custom launch button. "o"=One-time, "w"=Weekly, "m"=Monthly, "q"=Quarterly, "y"=Yearly. Important: These frequencies must be enabled on your Form from within your platform.
Prefill donation and donor information with URL parameters. This improves your donors' experience and is particularly useful for email marketing campaigns because it uses merge tags to build a unique URL.
Add the following string to the url of a page on your site that hosts a Donation Form V1 or click to see a demo of all parameters.
Embed an open Form directly on your page. We call this a "placed form." Change
isPopup: true to
isPopup: false. Be aware that the form will change in height as a user progresses through the flow. This example adds an additional wrapper div to center the placed form.
If you are using the Placed variation for the Giving Form, you'll want to make sure you are also presenting mobile visitors with the best experience. While the Popup variation of the form is mobile friendly, the Placed form variation may not be, depending on your site layout.
By default, your Form uses your platform currency. You can override your default or add multiple currencies, then configure the ask buttons for each currency.
You can customize all the text on the Donation Form: change a few words or translate the entire form. You must enter the text on your donation form exactly as it exists first then enter your desired text next. This method also works with structured data, like structured state-country picklists.
To set structured country and state fields, add
structuredStateCountry: true to your Form configuration script.
You can redirect the user onSuccess. This can be used with a special "Thank-you" page or url for analytics tracking. PayPal is special and has its own redirection link configurable from the Donation Form Editor. Please keep in mind, as with all custom implementations, this is only an example and not all browsers will treat this the same way. Be sure to fully test your unique solution.
reCAPTCHA is a tool from Google that helps reduce bots and fraud attempts on your Donation Forms. Setup is easy but involves several steps and configuration in both your Funraise platform and in the Form code. Get step-by-step instructions at the link below.Learn how to set up reCAPTCHA
We’ve made it easy for developers to use our native event handlers,
onSuccess to pass donation and donor properties to your own custom functions.
onFailure can take donor properties while
onSuccess can take both donor and donation properties.
You can use 3rd party technologies like Google Analytics and Facebook to track marketing attribution and donation events. There are many ways to track donation events; the method you use will depend on your nonprofit's strategy.View Analytics Tracking Tipschevron_right
With Donor Store activated, a donor’s information will be cached in their browser. When they return to any Giving Form V1, their information (not including payment information) will be populated automatically. To activate, add
useDonorStore: true to your Form Configuration Script
You can set the allowed frequencies for a Giving Form from the Configuration Script by adding