URL Shortcuts

Last Updated: Dec 21, 2015

This document lays out the specification of passing custom parameters into the form's donation page URL in order to pre-fill form fields.

URL Shortcut Parameters

Personal Information Parameters:


To pre-fill personal information fields, pass the fields and field values into the URL using a trailing "/v/" with field/value pairs comma delimited

Ex. https://secure.qgiv.com/for/[key]/v/first_name=Qgiv,last_name=Tester

The above example will prefill the first name and last name fields.




Donation Amount Parameters


To pre-select a custom giving amount, add a trailing "/amount/[value]" to the URL. This structure will only work with active suggested amounts for the given form.

Ex. https://secure.qgiv.com/for/[key]/amount/50.00


To pre-fill the "other amount", add a trailing "/amount/other/[value]" to the URL.

Ex. https://secure.qgiv.com/for/[key]/amount/other/22.50




Restriction Parameters


To pre-select a restriction, add a trailing "/restriction/[name]" to the URL. This structure will only work with active restrictions for the given form.

Ex. https://secure.qgiv.com/for/[key]/restriction/Test Restriction


To pre-select a subrestriction, add a trailing "restriction/[custom restriction name]/subrestriction/[name]" to the URL. This structure will only work with active subrestrictions under the selected restriction.

Ex. https://secure.qgiv.com/for/[key]/restriction/Custom Restriction/subrestriction/Test subrestriction




Event Parameters


To pre-select an event, add a trailing "/event/[event ID]" to the URL. This structure will only work with active events for the given form.

Ex. https://secure.qgiv.com/for/[key]/event/[event ID]




Pledge Parameters


To pre-select a pledge, add a trailing "/pledge/[pledge ID]" to the URL. This structure will only work with active pledges for the given form.

Ex. https://secure.qgiv.com/for/[key]/pledge/[pledge ID]




Internal Parameters

To add associated info to a transaction, add a trailing "/info/[data]" to the URL. This information will NOT be visible to the donor, but will store the associative data for the transaction upon submission.

Ex. https://secure.qgiv.com/for/[key]/info/[Associated Data]




Stacked Parameters

URL parameters can be stacked to pre-fill and/or pre-select multiple fields

Ex. https://secure.qgiv.com/for/[key]/restriction/Test Restriction/amount/50.00/v/first_name=Qgiv,last_name=Test

In the above example, the Test Restriction restriction will be pre-selected, the 50.00 custom amount will be pre-selected, and the first/last name fields will be pre-filled.


* denotes a required field

** denotes a required field based on Event settings

*** denotes a field that is only required when submitting Form level API credentials