Skip to main content

Giving Form Url Parameters

Pass-through values and default form behavior with URL parameters

Written by Tony Sasso

You can default form values with URL parameters. URL parameters are a code-free method that enables dynamic donation pages. URL parameters work out-of-the-box and do not require any special setup, other than adding parameters to your donation page links.

URL parameters can be added to any links sent from an email, social media posts, or ads — basically any time you send a link to to a donation oage, you can add parameters.

URL parameters

Setting

Parameter

Notes

Allocation

x_allocation=[FormAllocationId]

Allocation must exist on the form.

Form Allocation Ids are form-specific. To access the Form Allocation Id, open a form's editor and find the form's allocations.

Amount

x_amount=500

Ask String

x_ask=5,10,15,20

Frequency

x_frequency=m

Frequency must exist on the form.

o=one-time, w=weekly, m=monthly, q=quarterly, y=yearly.

Tickets (preselected tickets)

x_tickets=[ticketId]|[qty],[ticketId]|[qty]

Tickets must exist on the form.

Transaction Tags

x_tags=example

For multiple tags use # as a delimiter, for example: x_tags:#tag1#tag2

First Name

x_firstName=Janis

Last Name

x_lastName=Wallis

Email

x_email=janis%40example.org

Keep in mind, parameters myst be URL safe (URL Encoded) — not all charactors are valid in a URL


Examples

You can have a single donation page, but have multiple links that open the form at various frequencies:

  • Monthly default: example.org?x_frequency=m

  • Weekly default: example.org?x_frequency=w

Or you might want to segment your low and high-capacity donors and email them unique donation links to the same form but set it to open with different suggested donation amounts:

  • Low: example.org?x_ask=5,10,15,20

  • High: example.org?x_ask=500,1000,1500,2000


Building URL Parameters

Single parameter

When adding a single parameter, you'll add it to the end of your donation page link after a ?. (The question mark is the universal way to tell the browser that the following content is parameters that will be used by the page).

example.org?x_frequency=m

Multiple parameters

Multiple parameters are separated by &.

example.org?x_frequency=m&x_firstName=Janis&x_lastName=Wallis

Did this answer your question?