Link Microsurveys

In addition to Web and Mobile microsurveys, Sprig provides the ability to embed or share a link to a microsurvey. Link Microsurveys can be sent via email, SMS or shared inside of messaging platforms like Slack.

Customize Link Microsurvey

  1. Choose a Template.
  2. Customize the questions by selecting the Question tab and then add or delete questions. Be sure to review the skip logic as well.
  3. In the Audience tab, click the Shareable Link platform.
  1. If you're planning to perform a concept test, paste the Figma link into the section called Concept Testing, else proceed to the Total Response section.
  2. Configure Total Responses by selecting an option.
  1. Preview survey
    Before launching, the Preview Survey feature allows you to share the microsurvey with colleagues. No responses will be recorded from the preview microsurvey.
  2. Launch survey
    Click Launch Survey, to generate a link to the microsurvey that you may use to send to respondents.
    After launching the microsurvey, in the Summary tab, you can retrieve the link at any time by clicking Share Survey near the top of the page.

Embed Link Microsurvey

A popular workflow for out of product research is the ability to embed Sprig microsurveys within an HTML newsletter or website. Some of the best-known newsletter communities utilize this method to measure content performance. Two of our favorite are listed below. We fondly reference them in the following Template Collection in our Template library.

️ Warning

Only the first question in a microsurvey can be embedded, all other questions must be answered on a page redirect. Only multiple choice single answer, 1-5 rating scale, or NPS questions can be embedded.

  1. Create a Shareable Link Survey
  2. Copy and paste the Shareable Link Microsurvey into your newsletter, website or SMS message
  3. Send your microsurvey
  4. Review Responses

Embed Custom URLs for Response Selection

Sometimes, you'll want the newsletter subscriber or website visitor to choose a response to the first question and then ask them one or two more followups. Typically, presenting the options to choose from as the first part of the interaction, helps increase response rates. To do this, after creating a Link microsurvey and depending on the question type of your first question in the survey, you'll append a value to the URL that follows a pattern of ?r=value.

If the question type expects a numerical answer in a scale such as the 1-5 Rating Scale or NPS you'll place a number for ?r=value. If the question type expects a response value of text, such as Multiple Choice Single Select you'll append the values that match the response answer.

  1. Create a Shareable Link Survey. It should look something like this
  2. Create Custom URLs using a text editor to prepare your newsletter or website
  3. Copy and paste the customized URLs into your newsletter, website or SMS message
  4. Send your microsurvey
  5. Review Responses

Create Custom URLS

1-5 Rating Scale

Add ?r=, followed by the rating (1-5) to the end of the link microsurvey's URL



Follow the same pattern described above for 1-5 Rating Scale, but the range is from 0 to 10.

Multiple Choice Single Select

For multiple-choice single select you will also augment the URL with a ?r=, but will need to account for the response label's text values (e.g. the answers for your user to choose from should be appended to the URL at the end)


The URLs for the option above are appended with ?r=great, ?r=good and ?r=meh:



For punctuation, periods, commas, and apostrophes are dropped from the URL, whereas exclamation marks and question marks are to be kept.
Change all capitalized letters back to lowercase.

Example HTML

The following shows how you might integrate the links into a web page using the previous microsurvey as an example.

How would you rate this week's newsletter?

Great | Good | Meh


<p>How would you rate this week's newsletter?</p>
   <p><a href="">Great</a> | 
   <a href="">Good</a> |  
   <a href="">Meh</a></p>
Example taken from [Lenny Rachitsky's]( NewsletterExample taken from [Lenny Rachitsky's]( Newsletter

Example taken from Lenny Rachitsky's Newsletter

Enrich Responses for Link Microsurveys

Sometimes you might like to include extra data with your survey data in addition to the question responses. For example, as Link Surveys are anonymous, you may want to parse the respondent's identity as a parameter. This enables you to conduct a more sophisticated analysis that would not be possible if you just used the response data alone. These data may include characteristics (email, user id, etc.) you knew about respondents beforehand or the A/B group the respondent was assigned to in a research study. The data might typically be stored on a 3rd party marketing platform, such as, Iterable, Mailchimp, or ConvertKit. The data are incorporated as parameters into the URL of the link survey that you would send out to prospective respondents. The process of incorporating this additional data into survey responses is known as response enrichment.

The steps in the process to create a link survey with response enrichment are:

In Sprig:

  1. Create a Sprig microsurvey.

  2. Launch the microsurvey.

  3. Copy the link from Sprig.

In the 3rd Party Marketing Platform:

  1. Parameters representing the extra data are then added to the end of the Sprig survey URL. Parameters take the form of name-value pairs with ampersand & separators:*survey_id*?param1=val1&param2=val2&param3=val3
    Real-world example:



    You can add a maximum of 25 parameters per link, and the associated variables can have a maximum length of 1000 characters. The parameter r is reserved for use by the Custom URLs feature, user_id is reserved for parsing the userID to Sprig, and visitor_id is reserved for internal use.

  2. Distribute your survey link through the usual means, for example, email or SMS.

In Sprig:

  1. Once the survey has been distributed and responses received, in Sprig, the data, including the response enriched data, can be retrieved through the CSV export feature or the API. The name-value pairs are grouped under the category Custom Metadata in both the CSV file and API.

To use the API to retrieve the survey responses:

  • Go to Retrieve Responses
  • Input the sid, or Survey ID. The Survey ID is a unique integer that is part of the URL when viewing a survey in Sprig.<Survey ID>
  • Set with_custom_metadata to TRUE.
  • In Sprig, click Connect > Public API > Get API Keys.
  • Copy the key for the survey's corresponding Environment.
  • In Retrieve Responses, paste the key in the Authorization field. Don't forget to prepend the key with Bearer .
  • Click Try It.