Search

Pre-populate Sign-up Form Fields via Query Parameter

  • Updated

 

If your service has access to user details (e.g. when signed in or just after sign-up), you can pre-populate sign-up forms (e.g. Get Election Reminders, Register to Vote or Check Your Registration) or election search with a user’s name, contact information and/or location.

When present in any TurboVote web page URL, the contents of any of the following query parameters will appear in their respective sign-up form fields (or be used to populate election search):

Field Notes

Adult

Reminders, Register to Vote, Check Your Registration and Election Search

Youth

Preregistration
email  

✅

 ✅
sms   ✅ ✅
first-name   ✅ ✅
middle-name   ✅ ✅
last-name   ✅ ✅
preferred-name Maps to Use a different name when messaging me option on all TurboVote account sign-up forms ✅ ✅
birth-date Accepts either
  • US Month-Day-Year with leading zeros (mm-dd-yyyy) or
  • ISO (yyyy-mm-dd) date formats
 ✅ ✅
street   ✅ ✅
street2   ✅ ✅
city   ✅ ✅
state Two letter state abbreviation e.g. NY ✅ ✅
zip United States 5-digit Postal Code e.g. 10001 ✅ ✅
zip4 United States Postal ZIP+4® ZIP Code™ number e.g. 10001 ✅ ✅

 

None of these parameters are required. You can pass along whatever you have for any or all of the parameters.

Once pre-populated, users can update populated fields and enter remaining form fields before submitting (and accepting Terms and Conditions).

Check out sample data populating embeds on our demo site: