What are URL parameters? 🧮

URL parameters are bits of information appended to the end of a URL to pass data to the page. The result is a pre-selected checkout process with one or more of the desired parameters, on both Givebutter.com links, and embedded Widgets!

The available parameters for Givebutter campaigns are:

amount - preselect an existing amount option (ie. 25, 50, 100, 250)
frequency - preselect an existing frequency option (monthly, quarterly, yearly)
fund - preselect a fund by the fund ID (numeric fund code shown in the dashboard)
promo - preselect a promo code (ie. EARLYBIRD)

Please note that it is not possible to pre-fill or pre-populate a donation form with individualized donor information such as name and address.

Using URL parameters ⚙️

Parameters are applied to a URL by adding ‘?’ to the end of the link. After the ‘?’, parameters have a name=value syntax.

Example:

https://givebutter.com/yourcampaign?amount=250

Widgets Example:

https://www.nonprofit.org/donate/?promo=EARLYBIRD

Multiple URL parameters ➕

You can also add multiple parameters to a URL! When more than one parameter is required, they must be separated by an ‘&’.

Example:

https://givebutter.com/yourcampaign?amount=250&frequency=quarterly

Widgets Example:

https://www.nonprofit.org/donate/?amount=99&frequency=monthly

Full URL examples 🔗

Pre-select amount and frequency:

https://demo.givebutter.com/form?amount=250&frequency=quarterly

Automatically apply a promo code:

https://demo.givebutter.com/livestream?promo=20OFF

Using parameters with Widgets 📝

Givebutter supports amount , frequency , fund and promo as widget parameters. If also using URL parameters, the priority is:

amount=25 as HTML tag parameter
?amount=25 as URL parameter

Example usage:

<givebutter-widget id="xLWmpB" amount="25"></givebutter-widget>
<givebutter-widget id="xLWmpB" amount="25" frequency="monthly"></givebutter-widget>

FAQ 🤔

What's the difference between URL parameters and UTM parameters?

URL parameters are elements added to a specific URL to pass information along when a link is clicked, ie. color=orange. These are not tracking-related. Read more about using URL parameters →

UTM parameters are pieces of code added to your campaign URL to keep track of online traffic by attributing a source, ie. Facebook. These are useful if you want to track where a donor first clicked on your campaign, or what the final touch for conversion was. You can learn more about UTM parameters via GA4 (Google Analytics).

Are URL parameters supported on embedded campaigns/Widgets?

Yes! Third-party websites that use Widgets are also supported. See above for different applications for Givebutter and external URLs.

Which fund code do I use for URL parameters?

Funds have a set numeric code in the dashboard, as well as an optional user-set code in the settings for each specific fund. For URL parameters, you'll need to use the code in the URL for the fund you want to use. The user-assigned code will not correlate to this fund.

Can you use UTM and URL parameters together?

Yes! Any URL parameters can be used together in the same URL as long as they are properly formatted with "&" between each one. For example, you may want to use UTMs in addition to any of the available URL parameters (ie. promo codes) in the same URL they are sharing via email, social, or QR code.