What is a URL Parameter, and how do you use them?
URL parameters are pieces of information that you append to the end of your links to the donation page.
If you’re sending these links out to individuals, you can use URL parameters to personalize donation links with specific donor information, like name and address data. If you are using URL parameters on donation links on your webpage, you’ll generally want to use them for activities like source coding, selecting a donation amount, or enabling recurring gifts.
You can prefill just about any field on your widget by including a URL parameter with a value for that field. For example, if you know that the donor’s name is John Smith, you can add the URL parameter “?FirstName=John&LastName=Smith” to insert the his first and last name fields on the donation widget.
You can set up URL parameters to auto-fill any text field on your widgets but remember these tips:
1. Don’t use any spaces in the field labels.
2. Be sure that the field label is spelled correctly.
3. URL encode any special characters in the field value (spaces become “%20”). For example: If the donor’s street address included Suite 123, the URL parameter would be “https://campaignwebsite.com/donate?StreetAddress2=Suite%20123”.
• Drop-down fields
Insert URL parameters to do the same with drop-down fields. Just use the field label for the URL parameter and use one of the selections from the dropdown menu as the value. For example, you could auto-fill the donor’s state with“https://campaignwebsite.com/donate?state=Virginia”.
For checkboxes, you can use the following values to check the box: “yes”, “true”, “on”. Use the following values to uncheck the box: “no”, “false”, “off”.
Note: We do not support URL parameters for credit card information for security reasons, and we do not support a URL parameter for the disclaimer for regulatory reasons.
Defining a donation amount
You can also pre-select a donation amount for a donor. This is particularly useful if your fundraising program requires a certain giving level, or the donor is clicking a link that mentions the donation amount (i.e. “Click here to donate $25).
Simply add ?Donation=25 to the URL, and it will automatically select the $25 donation amount on the form. If the donation amount that you provided doesn’t match any of the predefined amount options, the “Other” field will be used.
Note: If you’re using multi-step widgets, defining a donation amount in the URL will automatically move the donor to Step 2 of the form.
Recurring Gift Schedules
Encourage donors to set a recurring gift schedule by using URL parameters. To set this up, use the parameter“recurring=yes” to check the box and “Term=0”. You can set the duration of the recurring gift to “0” (until cancelled), “3”, “6”, “9”, or “12” months.
Source codes are a simple way to track where your gifts came from. These are tracked in the Widgets tab under the corresponding widget. When setting up your widget, you can set a default source code, but you can also override that source code by adding “?sc=[sourcecode]” to your URL. These source codes pass to a hidden field on the widget and are recorded in WidgetMakr even though the user doesn’t see them on the form.
Tracking Numbers are used to track gifts back to a specific fundraising in Crimson so that the fundraiser can get credit for the gift. Just add “?trackingnumber=[trackingnumber]” the the URL of the donation page. Tracking numbers pass to a hidden field on the widget and are recorded in WidgetMakr even though the user doesn’t see them on the form. They also get passed to Crimson.
Enable WidgetMakr’s test mode in order to test any of your widgets prior to using them publicly. By adding “?testmode=on” to the URL, you can go through the entire process of making a donation without processing a card or creating a new conversions. We’ll even send you the thank you email.
For reference, here are some commonly used URL Encoded characters:
|Character||Code It As|