A query string is something you can add to the end of the URL your form lives at, e.g. www.example.com/formid?foo=bar Primarily, query string values are used to pre-fill values in the form. The general format is that the first bit is the name of the form field, followed by an equals sign and then whatever data you wish to pre-fill that form field with. ActionTag assumes US formats for all fields (phone, postal code, amounts, etc.).
The way to add these onto a form is that the first one needs to use a question mark, and other subsequent ones use an ampersand, e.g. www.someurl.com/formid?sourceid=12345&ms=top-nav
Avoid using Query Strings with PII
It is not advised to put PII in your URL via query strings, as that can expose personal information to services like Google Analytics. SmartLinks should be used in Targeted Email instead of query strings.
The following are available visible fields to be filled via Query Strings:
Address Line 1
Address Line 2
Additional Contribution Value
Prefill the additional contribution amount on event forms only
This sets the default amount on a contribution form.
This sets the amount button options on a contribution form. To select a particular contribution amount upon loading the form, use the ‘am’ query string.
If the Cover Costs checkbox is enabled on the Contribution or Ticketed Event form, this query string checks that checkbox, adding the Cover Costs amount (configured in Online Actions) to the contribution amount selected by the donor.
Works for Contribution forms that support international currencies; will not work for Ticketed Event forms
• Valid values include USD, GBP, CAD, and EUR
• Can be used in combination with am and amtOpts
• If currency is passed without am or amtOpts, passed currency will be selected and amounts on form will be converted
• If currency is passed with amtOpts, passed currency will be selected and amount options will be offered as passed
• If supporter then selects a new currency, amounts will be converted to selected currency
• If currency is passed with am, passed currency and amount will be selected
2 • Black or African American
4 • Native American
5 • Native Hawaiian
6 • Other
7 • Pacific Islander
10 • Hispanic
12 • Middle Eastern
17 • Multi-racial
25 • Not Listed
26 • Asian or Asian American
27 • White
Recurring Commitment Amount
This sets the default amount for a recurring commitment on a contribution form.
Recurring Commitment Amount Options
This sets the amount button options for a recurring commitment on a contribution form.
Recurring Commitment Frequency
0 • one-time
1 • weekly
2 • every two weeks
3 • every four weeks
4 • monthly
5 • quarterly
6 • yearly
7 • twice a year
Recurring Commitment Duration
1 • until end of year
2 • until the election
3 • until I contact you
4 • until this date
3 • Asexual
5 • Bisexual
6 • Demisexual
21 • Gay
9 • Heterosexual
22 • Lesbian
19 • Other
14 • Pansexual/Omnisexual
18 • Prefer not to Say
16 • Queer
25 • Not Listed
SmsSubscribeMobilePhone=true or SmsSubscribeMobilePhone=false
There are also elements that may not be visible, but have to do with how the form submission data is entered into the database:
Attributed Contact ID
The contribution or event signup will have the specified contact attribution (if applied to the submission of a Contribution or Event form). The contact ID should be the VANID for an Online Actions form, or the NGP ID for a version 7 form. Since a single contribution can have more than one contact attribution, you may use a comma delimited list of IDs to attribute the contribution to more than one contact, i.e. attr=109418764,109419268
The contribution or event signup will have the specified contact attribution (if applied to the submission of a Contribution or Event form). The contact ID should be the VANID for an Online Actions form, or the NGP ID for a version 7 form.
Additionally, the ac query string will prefill the Host Committee member selection on the published form (if the query string value matches that of a Host Committee member configured for the Event).
Using this query string parameter disables FastAction and ActionProfile integration. This is useful if the user is using a form on a tablet or laptop in a public place and do not want the submission information remembered on that device. Notably, if you configure one form to redirect to another form (what we refer to as secondary ask), the form fields on the second fom will not be pre-populated by the submission info from the first form. If you are launching the form with knowledge of who a contact is, kiosk mode does still allow you to prefill form fields using other query string values, e.g. fn=Michelle as documented above.
Can be used to track different ad buys to the same form to compare ROI
Source Code ID
Either adds or overrides the defined source code on the form. You must use the source code ID, not the source code name.
Source Code Name
Will attempt to match to an existing source code of that name. If none exist, it will create a new source code of that name under the parent code of "Forms Auto-generated" which can then be moved elsewhere in your code hierarchy if needs be. V8 only.
Automatically submits the form and segues to the next action (thanks page, secondary ask, or an arbitrary other URL) if all the required fields are prefilled by either a query string value or ActionProfiles. This does not work for contribution or event forms.
Social Network Referral
snw=1 Facebook snw=2 Twitter
Indicates whether the user was referred to the form from Facebook or Twitter.