Pass-through parameters
Before you start
If you're not using a Studio campaign, check out our other guide on pass-through parameters for our legacy donation pages.
Pass-through parameters are tags you can add to the end of a website address to pass specific information onto the page’s form. With GoFundMe Pro, you can add pass-through parameters to your donation page’s address to preselect or enter donation amounts, frequencies, and more.
For example, you can include a pass-through parameter to preselect the $50 donation amount by adding ?amount=50. Then, share this web address with supporters in a $50 donation appeal.
Key considerations
Before you use parameters, it’s helpful to know that they work differently with certain campaign features:
- When Intelligent Ask Amounts is turned on, donation values and frequencies on the donation page can’t be overridden by the amount, preset, or recurring parameters. This does not apply to checkout if you want to use parameters in a checkout URL.
- The minimum and maximum amounts set in campaign settings still apply.
- The value for the recurring parameter only works if the certain donation frequency option is turned on. For example, recurring=1 will only work if the yearly frequency is turned on.
- The amount parameter is adjusted for donors based on their set currency. For example, if the amount parameter is set to $50, a donor with their currency set to EUR will see €46.
- If you turn on program designations on the donation form, you can use the designation parameter to show the designation in the menu.
Add pass-through parameters
Tip: Want to skip the manual setup? Use our URL builder to create a trackable campaign link with pass-through parameters already included.
To add a pass-through parameter to form:
- Find your donation page’s URL
- Type a question mark symbol (?) after the end of your website address
- Enter your passthrough parameter
For example: https://giving.gofundme.com/campaign/800220/donate?amount=50
Adding multiple pass-through parameters
To add more than one pass-through parameter, separate each additional parameter with the ampersand (&) symbol. For example:
https://giving.gofundme.com/campaign/800220/donate?amount=50&recurring=12&designation=12345
Adding parameters to checkout
If you want donors to skip the donation page, you can use parameters to send them a custom checkout URL. This is helpful when you want to ask your donors for a specific amount or donation frequency without turning off Intelligent Ask Amounts.
Your checkout URL starts with parameters for your campaign and GoFundMe Pro account IDs, then you can add more with the ampersand (&) symbol. For example:
https://giving.gofundme.com/checkout?cid=800220&oid=12345&amount=43.43
Important: Checkout uses the frequency parameter instead of the recurring parameter. Available values are: one-time, daily, weekly, bi-weekly, monthly, quarterly, semi-annually, and yearly.
List of supported parameters
Supported parameters include:
- amount= Passes a pre-selected donation amount in the campaign's default currency to the landing page. The amount appears in the other field unless the amount is equal to one of the predefined amounts.
- preset= Updates the amounts listed on your four donation amount buttons. For example, preset1=100 would make the first donation amount button display $100
- currency= Defines the currency for the checkout. For example, USD for the US dollar or EUR for the Euro. Donors can still manually change the currency they want to donate with. For more information, check out our complete list of supported currency codes.
- designation=program designation ID Specifies the program designation selected on the donation page. You can find program designation IDs by selecting Settings, then Program Designations in your GoFundMe Pro account. Learn more about program designations.
- recurring=0 Make the default donation frequency a one-time donation
- recurring=12 Make the default donation frequency a monthly donation
- recurring=4 Make the default donation frequency a quarterly donation (every 3 months)
- recurring=2 Make the default donation frequency a semi-annual donation (every 6 months)
- recurring=1 Make the default donation frequency a yearly donation
- recurring=365 Make the default donation frequency a daily donation
- recurring=52 Make the default donation frequency a weekly donation
- recurring=26 Make the default donation frequency a bi-weekly donation
Parameters that may require encoded values
While anyone can use the following parameters, we recommend seeking assistance from someone with knowledge of encoded values. If you plan to add spaces or special characters (for example, an @ symbol for emails or a space in a street address), you'll need to know how to use encoded values.
The additional parameters you can use include:
- first= First name appears in the checkout form
- last= Last name appears in the checkout form
- email= Supporter’s email appears in the checkout form
- phone= Phone number appears in the checkout form
- street= Street address appears in the checkout form
- city= City appears in the billing part of the form
- state= State appears in the billing part of the form
- zip= Zip code appears in the billing part of the form
Note: GoFundMe Pro does not provide code development services. In any case, we recommend starting with the parameters that don’t require coding—they have a more direct impact on donations.
Supported parameters for embedded forms
The following parameters are supported in both the inline donation grid and embedded form:
- amount= Passes a pre-selected donation amount in the campaign's default currency to the landing page. The amount appears in the other field unless the amount is equal to one of the predefined amounts.
- preset= Updates the amounts listed on your four donation amount buttons. For example, preset1=100 would make the first donation amount button display $100
- frequency= Set the donation frequency. Available values are: one-time, daily, weekly, bi-weekly, monthly, quarterly, semi-annually, and yearly.
- currency= Defines the currency for the checkout. For example, USD for the US dollar or EUR for the Euro. Donors can still manually change the currency they want to donate with. For more information, check out our complete list of supported currency codes.
The following parameters are only supported in the embedded form:
- designation=program designation ID Specifies the program designation selected on the donation page. You can find program designation IDs by selecting Settings, then Program Designations in your GoFundMe Pro account. Learn more about program designations.
- recurringEndDate= Sets an end date for a recurring donation if a recurring frequency is active. Format: YYYY-MM-DD
- first= First name appears in the checkout form
- last= Last name appears in the checkout form
- email= Supporter’s email appears in the checkout form
- phone= Phone number appears in the checkout form
- street= Street address appears in the checkout form
- city= City appears in the billing part of the form
- state= State appears in the billing part of the form
- zip= Zip code appears in the billing part of the form
Use pass-through parameters with source codes
You can use pass-through parameters with source codes, but the pass-through parameters must come after any source codes. For example:
https://giving.gofundme.com/campaign/800220/donate?c_src=email&recurring=12
Source codes with embedded forms
Source codes only work with the embedded form, not the inline donation grid. Your embedded form already has a ? in the URL, so you'll add an ampersand (&) instead before entering c_src=. For example: https://giving.gofundmepro.org/?campaign=12345&c_src=email