You can dynamically prepopulate certain values in your donation forms, event registrations, and widgets with some small adjustments to the URL.

Personal Information

To pre-fill personal information fields for donation forms and event registrations, add a "/v/" to the end of the URL with a comma separated list of field references and the value for that field.

Below is an example of pre-filling the first name and last name:

Before: https://secure.qgiv.com/for/myformkey/

After: https://secure.qgiv.com/for/myformkey/v/first_name=John,last_name=Smith

Available field references:
- first_name
- last_name
- address1
- address2
- city
- state
- zip
- company
- phone
- email

Please note: The "company" field cannot be used for event registrations.

Donation Amounts

If you're using the Custom Amounts system on your donation form, or if you've enabled one-time donations for your event registration, you can pre-select a specific giving amount by adding "/amount/" to the URL plus the amount of the option you want pre-selected.

Below is an example of pre-selecting a $50 donation amount:
https://secure.qgiv.com/for/myformkey/amount/50.00
You can also pre-fill the "other" amount option if you have it enabled by adding "/amount/other/" plus the amount you want to pre-fill it with.

Below is an example of pre-filling the other amount with a donation of $55.55:
https://secure.qgiv.com/for/myformkey/amount/other/55.55

Restrictions

You can pre-select restrictions and sub-restrictions by adding a trailing "/restriction/[name]" to the URL. This will only work with active restrictions.
You can easily access this by going to "Restrictions" section in your control panel and clicking the "Copy URL" button next to the restriction.

Events

If you have more than one active event, you can pre-select an event by adding "/event/" plus the event ID to the end of the donation form URL.

Example: https://secure.qgiv.com/for/myformkey/event/12345

Frequency

To pre-select a recurring frequency for donations, add “/frequency/[frequency_letter]” to the end of the URL.
frequency_letter can be any one of the following:

w for Weekly
b for Every Other Week
m for Monthly
q for Quarterly
s for Semiannually
a for Annually

Below is an example of pre-selecting a monthly donation frequency:
https://secure.qgiv.com/for/myformkey/frequency/m

All of the above options can be combined as well. For example, if you wanted to pre-select a certain giving amount and also pre-fill the first name and last name you can accomplish that by doing the following:

https://secure.qgiv.com/for/myformkey/amount/50.00/v/first_name=John,last_name=Smith

Widgets

All of the options above are also available with our Widget system. To customize the URL outside of what's already offered in the Widgets interface, add the additional parameters to the URL in the "data-embed" attribute of your widget embed code.

Example:

Use Cases

We've identified a few different ways you can use this functionality to enhance your experience with the Qgiv platform.

Use this functionality to work with your existing login system so that donation forms can be pre-filled with user data once they've logged in to your own account system.
Send emails with a call-to-action button that asks for a specific giving amount. Use the amount pre-fill option to automatically select that amount when a user visits your form. Additionally, if your email service uses tags to populate things like first name and last name, you can use the personal information pre-fill options to save your donors the extra step of filling in their name!
If you're using your form for multiple events, you can add registration links to your site for specific events using a direct link to the event.

Prepopulating Form Values Using URL

Contents: