Query Strings

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.

Form Fields

The following are available visible fields to be filled via Query Strings:

NameParameterSampleNotes
Address Line 1add1add1=1250+Hancock+St.
Address Line 2add2add2=Ste.+202
Additional Contribution ValueAdditionalContributionValueAdditionalContributionValue=25Prefill the additional contribution amount on event forms only
Amountamam=5This sets the default amount on a contribution form.
Amount OptionsamtOptsamtOpts=3,5,20.16,50,100This sets the amount button options on a contribution form. To select a particular contribution amount upon loading the form, use the ‘am’ query string.
Citycici=Boston
Cover CostsCoverCostsCoverCosts=trueIf 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.
Currencycurrencycurrency=EURWorks 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
Email Addressem[email protected]
Email Signupaeae=true or ae=false
Employerepep=ACME Industries
Ethnicityethnethn=1,2,31 • Afghani
2 • Arab
4 • Bangladeshi
5 • Bhutanese
6 • Brazilian
7 • Chinese
8 • East African
9 • Filipino
10 • Haitian
11 • Hmong
12 • Indo Carribean
13 • Lao
14 • Nepali
15 • Pakistani
16 • Somali
17 • Sri Lankan
18 • Tibetan
19 • Vietnamese
20 • Latino
21 • Arabian
22 • Armenian
25 • Indian
26 • English (British)
27 • French
28 • German
30 • Irish
31 • Italian
32 • Japanese
34 • Polish
35 • Native American
36 • Scottish
37 • Swedish
39 • Samoan
40 • Korean
44 • Czechoslovakian
45 • Norwegian
46 • Dutch
47 • Greek
48 • Hungarian
50 • Russian
51 • Ukrainian
52 • Welsh
54 • Bulgarian
55 • Burmese
56 • Cambodian
57 • Estonian
58 • Ethiopian
59 • Finnish
60 • Icelandic
61 • Indonesian
64 • Latvian
65 • Lithuanian
66 • Malaysian
67 • Manx
68 • Portuguese
71 • Swiss
72 • Thai
73 • Turkish
74 • Yugoslavian
75 • Danish
77 • Hawaiian
78 • African American
82 • Hispanic
83 • Mixed Ethnicity
85 • Other
86 • Persian
87 • Yemeni
88 • Egyptian
89 • Morrocan
90 • Lebanese
92 • Jewish
93 • Chamorro
96 • Mien
97 • Bengali
98 • Chin
99 • Karen
101 • Mongolian
103 • Okinawan
104 • Singaporean
105 • Taiwanese
106 • Tongan
109 • Colombian
110 • Salvadoran
120 • Unknown
136 • Not Listed
137 • Tagalog
138 • Native Alaskan
142 • Pacific Islander
Facebook Profile Urlfbfb=http://www.facebook.com/JohnAdamsPresident
First Namefnfn=John
Gendergengen=1,2,31 • Androgynous
2 • Female
4 • FTM
5 • Gender Fluid
6 • Gender Non-conforming
7 • Genderqueer
8 • Male
11 • MTF
12 • Non-Binary
13 • Prefer Not to Say
14 • Questioning
16 • Transgender
18 • Agender
20 • Bigender
21 • Butch
22 • Femme
23 • Gender Questioning
24 • Gender Variant
25 • Genderless
27 • Intersex
28 • Masc
29 • Neither
30 • Neutrois
31 • Non-Op
32 • Other
33 • Pangender
34 • Polygender
35 • Queer
36 • Transfeminine
37 • Transgender Female
38 • Transgender Male
40 • Transgender Person
42 • Transmasculine
49 • Two Spirit
56 • Not Listed
57 • Third Gender
58 • Cisgender Male
59 • Cisgender Female
Home Countrycc=US; c=CA
Home Phonehphp=6175551234
Is Organizationis_orgis_org=true or is_org=falseThis checks or unchecks the checkbox to submit the form on behalf of an organization (not available on all form types).
Is Recurringrr=trueUse true or false to set an exposed recurring checkbox to be checked or not, respectively.
Last Namelnln=Adams
Middle Namemnmn=Quincy
Mobile Phonempmp=6175551234
Occupationococ=President
Organization Emailorg_em[email protected]This pre-fills the Organization Email input.
Organization Nameorg_nameorg_name=People+for+GoodThis pre-fills the Organization Name input.
Organization Phoneorg_hporg_hp=2025551000This pre-fills the Organization Phone input.
Postal Codepcpc=02144
Preferred Languagepreflangpreflang=21 • Bengali
2 • Cantonese
3 • English
4 • French
5 • Gujarati
6 • Hindi
7 • Japanese
8 • Korean
9 • Malayalam
10 • Mandarin
11 • Nepali
12 • Punjabi
13 • Russian
15 • Spanish
16 • Tagalog
17 • Tamil
18 • Tibetan
19 • Urdu
20 • Vietnamese
22 • Armenian
26 • German
28 • Italian
30 • Polish
31 • Swedish
32 • Samoan
36 • Norwegian
37 • Dutch
38 • Greek
39 • Hungarian
42 • Bulgarian
43 • Burmese
45 • Estonian
47 • Finnish
48 • Icelandic
49 • Indonesian
50 • Hebrew
51 • Lao
52 • Latvian
53 • Lithuanian
55 • Portuguese
57 • Thai
58 • Turkish
60 • Danish
62 • Amharic
63 • Arabic
64 • Croatian
65 • Somali
66 • Tigrinya
67 • Hmong
68 • Bosnian
69 • Creole
70 • Serbian
71 • Ukranian
72 • Bhutanese
73 • Chamorro
74 • Ilocano
75 • Karenni
78 • Swahili
79 • Tokelauan
80 • Kannada
81 • Marathi
84 • Hakha Chin
88 • Malay
89 • Mandingo
111 • ASL
112 • Not Listed
113 • Khmer
115 • Simplified Chinese
116 • Czech
119 • Iu Mien
120 • Sinhala
121 • Filipino
122 • Traditional Chinese
123 • Slovak
Prefixpp=Mr
Pronounpropro=11 • She/Her/Hers
2 • He/Him/His
3 • They/Them/Theirs
4 • Xe/Xem/Xyrs
5 • (F)ae/(F)aer/(F)aers
6 • E/Em/Eirs
7 • Ey/Em/Eirs
8 • Per/Per/Pers
9 • Sie/Sie/Hirs
10 • Tey/Ter/Ters
11 • Ve/Ver/Vers
12 • Ve/Ver/Vis
13 • Ze/Hir/Hirs
14 • Zie/Zim/Zis
15 • She/Them/Theirs
16 • He/Them/Theirs
17 • Name Only
18 • He/She/They
19 • Any/All Pronouns
Raceracerace=12 • 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 AmountrecurringAmrecurringAm=5This sets the default amount for a recurring commitment on a contribution form.
Recurring Commitment Amount OptionsrecurringAmtOptsrecurringAmtOpts=5,10,15,25,35,50This sets the amount button options for a recurring commitment on a contribution form.
Recurring Commitment FrequencySelectedFrequencySelectedFrequency=40 • one-time
1 • weekly
2 • every two weeks
3 • every four weeks
4 • monthly
5 • quarterly
6 • yearly
7 • twice a year
Recurring Commitment DurationSelectedDurationSelectedDuration=31 • until end of year
2 • until the election
3 • until I contact you
4 • until this date
Sexual Orientationsexorientsexorient=1,2,33 • 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
SMS SignupSmsSubscribeMobilePhoneSmsSubscribeMobilePhone=true or SmsSubscribeMobilePhone=false
Spouse Namesnsn=Abigail+AdamsSupported in version 7 only.
State Provincestst=MA
Suffixss=Esq.
Twitter Handletwtw=the_real_adams
Work Address Line 1w1w1=1600+Pennsylvania+Ave
Work Address Line 2w2w2=Oval+Office
Work Citywcwc=Washington
Work Countrywcowco=US; wco=CA
Work Emailwe[email protected]
Work Phonewpwp=2025551234
Work Postal Codewzwz=20500
Work State Provincewsws=DC

Form Submission Data

There are also elements that may not be visible, but have to do with how the form submission data is entered into the database:

NameParameterSampleNotes
Attributed Contact IDattrattr=109418764The 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
Host Committeeacac=VN96C3TBX36The 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).
Kiosk Modekioskkiosk=trueUsing 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.
Market Sourcemsms=201409_fb_birthday_v1Can be used to track different ad buys to the same form to compare ROI
Source Code IDsourceidsourceid=57Either adds or overrides the defined source code on the form. You must use the source code ID, not the source code name.
Source Code Namesourcesource=e2106ndWill 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.
Quick Signquickquick=trueAutomatically 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 Referralsnwsnw=1 Facebook
snw=2 Twitter
Indicates whether the user was referred to the form from Facebook or Twitter.