In This Article:

    Passing Data into Salsa Forms—For Advanced Users

    In This Article:

      Salsa Engage allows you to pass in field data via a query string so that you can pre-populate info on your forms. Here's how it works:

      1. Identify the parameters you wish to pass into the form fields
      2. Append those variables to your activity address
      3. Share the full address on your website or other channels

      Default Parameter Names and Variables

      Each form field on a Salsa Engage Activity page has a parameter name (this includes custom fields). 

      Below is a list of our default fields you can pass in a query string to pre-populate the fields on the forms.  The variables are in italics:

      Field Name Variable
      First Name person-firstname
      Last Name person-lastname
      Email Address contact-email
      Address Line 1 address-line1
      Address Line 2 address-line2
      City address-city
      State address-state
      Postal/Zip address-zip
      Country address-country
      Donation Amount amount
      Set the donation as recurring? recurring (value of yes) 
      Opt-in Status for emails receive-updates (value of yes)


      For Custom Fields, the variable will always start with scf and then the field name. You can access the parameter value by clicking on that field in your activity form:


      Write the URL

      The format of the Salsa activity form is standard for any query string, just like UTM parameters for Google Analytics.

      For example, the default activity link would look like

      When using the parameters above, you could populate the name, email and donation amount by setting it up as...

      *If your donation form does not have a button for $10, this would be populated directly into the Other amount field.  If you do not have the Other amount box, none of those options will populate with a choice.

      This string uses the following symbols:

      Symbol Definition
      ? Use the question mark only after the URL. It indicates that what follows is a query string.

      Use the "equals" sign to indicate with what the field for the parameter that you enter should be populated.

      &  Use the ampersand to concatenate multiple parameters/value combinations.


      Manually Add Tracking Codes to a URL 

      Salsa Engage also enables you to add a Salsa Tracking Code parameter to your URLs manually. For instance, you are adding your URL to an online ad and want to measure ROI from that activity. You'll be able to see and compare "Views" and "Conversions" metrics in your activity results to measure which code is performing the best for that activity.


      To use a Salsa Tracking Code, simply add the following field-value pair to your URL query string:


      A URL with a tracking code would look like this: Boy&person-lastname=Walton&

      You can query for these codes on specific activity forms in Engage.  Use the Salsa Tracking Code option by going to Supporters > Query > Create a new query.


      Salsa Tracking Code data is also available in activity and transaction CSV export files in the "Salsa Track" column.

      Add Default Tracking Codes to Activities

      Please see this article for more information on adding a default tracking code on an Activity for identifying the source of a transaction or supporter if you do not pass the code into your form.


      Was this article helpful?
      0 out of 0 found this helpful
      Have more questions? Submit a request



      Article is closed for comments.