Donation Form Reference

The donation form allows users to donate to your fundraisers. This reference explains all the attributes that can be added to the embed code to modify its style and behavior.

Embedding a Donation Form Learn how to embed a donation form.

Fundraiser Identifier Parameters

These are the parameter combinations required to embed donation forms from the various types of fundraisers you can create via Pledge. Identify your fundraiser type and use only one of the following parameter combinations.

Impact Hub Fundraisers

Fundraisers created via the Impact Hub.

data-widget-id (required)

type: string

The widget ID for your fundraiser

<div class="plg-donate" data-widget-id="[WIDGET ID]"></div>

API Fundraisers

Fundraisers created via the fundraiser API.

data-partner-key (required)

type: string

Your partner key

data-item-id (required)

type: string

The fundraiser ID

<div class="plg-donate"
  data-partner-key="[PARTNER KEY]"
  data-item-id="[FUNDRAISER ID]"></div>

EIN Fundraisers

For our partners that need a programmatic way to embed a donation form that supports any organization on the fly, we provide a way to embed a donation form without creating a fundraiser first.

data-partner-key (required)

type: string

Your partner key

data-ein

type: string

Nonprofit organization EIN (aka NGO ID)

<div class="plg-donate"
  data-partner-key="[PARTNER KEY]"
  data-ein="[EIN]"></div>

Other Parameters

lang

type: BCP 47 language tag (e.g. 'en-US'; see HTML lang global attribute on MDN)

Language in which to render the donation form

<div class="plg-donate"
  data-widget-id="..."
  lang="es-MX"></div>

data-amount

type: number

Sets the default donation amount

<div class="plg-donate"
  data-widget-id="..."
  data-amount="50"></div>

data-first-name

type: string

Pre-fills the donor’s first name

<div class="plg-donate"
  data-widget-id="..."
  data-first-name="Sam"></div>

data-last-name

type: string

Pre-fills the donor’s last name

<div class="plg-donate"
  data-widget-id="..."
  data-last-name="Williams"></div>

data-email

type: string

Pre-fill the donor’s email address

<div class="plg-donate"
  data-widget-id="..."
  data-email="sam@williams.com"></div>

data-currency

type: currency code string (e.g. 'usd')

Sets the default currency

<div class="plg-donate"
  data-widget-id="..."
  data-currency="cad"></div>

data-style-brand-color

type: hex color string

Sets the main color of the donation form

<div class="plg-donate"
  data-widget-id="..."
  data-style-brand-color="#fc2352"></div>

data-style-hide-social

type: boolean

Hides the button on the post-donation screen to share the fundraiser on social media

<div class="plg-donate"
  data-widget-id="..."
  data-style-hide-social="true"></div>

data-template

type: string

Uses a template name to load the appropriate configuration

<div class="plg-donate"
  data-widget-id="..."
  data-template="[TEMPLATE]"></div>