Loading...
  • Customer Experience
    Customer Experience
  • Employee Experience
    Employee Experience
  • Brand Experience
    Brand Experience
  • Product Experience
    Product Experience
  • Core XM
    Core XM

Authenticators

What's on This Page:


Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!


About Authenticators

Sometimes you need all the benefits of a unique survey link without actually creating or sending out a unique link. Authenticators allow you to do just this, letting you collect responses that are connected to contact list information without generating unique links. Authenticators make this possible by having respondents “log in” to take a survey. This means that you can copy the Anonymous Link to a website or into an email and still track who has responded. Only people who are listed in your contact list can take the survey, so you won’t collect unwanted responses even when using the Anonymous Link.

Qtip: To learn how to set up an Authenticator that checks a third-party service instead of a contact list (e.g., a university login system or Facebook login), refer to our SSO Authentication page.

Authenticator Functionality

Authenticators are elements in your Survey Flow, just like Branch Logic or Randomizers.

When a respondent reaches an Authenticator, they are prompted to input certain pieces of information, like an email address or password (you determine the exact field when you set up the Authenticator). Once they enter the information, Qualtrics checks one of your contact lists (you specify which one) to see if the provided information matches any of those contacts. If there is a match, the authentication is successful and the respondent proceeds into the authenticated section of the survey.

Qtip: Only the Email or ExternalDataReference contact list fields can be used to authenticate. If you would like to authenticate using a value other than a respondent’s email, make sure to include these values in the ExternalDataReference column of your contact list. You can only use an Embedded Data field if you also authenticate with the Email or ExternalDataReference fields.

If the information is incorrect, the authentication fails and the respondent is prompted to re-enter the information. If the respondent continues to fail, they will be skipped past the authenticated section of the survey. If there is not anything after the authenticated section, the survey will continue to the end of survey message and their response will be recorded.

Qtip: Make sure that the respondent has the information they need to log in to the Authenticator.

Setting Up an Authenticator

Qtip: Before you follow these steps, make sure you’ve created your contact list first!
  1. In the Survey tab, navigate to the Survey Flow.
    Survey Flow button in the upper-left of the Survey tab
  2. Click Add a New Element Here.
    Add a New element button at the bottom of the Survey Flow and the What do you want to add? menu that opens above
  3. Select Authenticator.
  4. Move the Authenticator to the beginning of your Survey Flow by clicking Move and dragging the authenticator to the top.
    Move button on lower-right of the authenticator; blocks indented under authenticator

    Qtip: When capturing Embedded Data from a Contact List and using an Authenticator, the order of Survey Flow elements is extremely important. In the below example, the values for Embedded Data field Unique ID are set from Contact List A which was used to distribute the survey. Respondents need to authenticate into the survey using the Unique ID field, but the Authenticator is set to authenticate against a different contact list called Contact List B. Because the Authenticator comes after the Embedded Data in the Survey Flow, the response will have the value for Unique ID from Contact List B. The Survey Flow reads elements from top to bottom, so values may be overwritten if defined in multiple places. You can find more information about the importance of Survey Flow element order on the Survey Flow page.
    Image of Survey Flow with Embedded Data and Authenticator elements
  5. Nest the blocks you’d like to authenticate beneath the Authenticator element.
    Qtip: Make sure all blocks that you want authenticated are nested under the Authenticator element. This means they are not on the same outside tier as the Authenticator in the Survey Flow, but are indented or nested under the Authenticator.
  6. Select the library and contact list you’ll use to verify each respondent’s information.
    Options and fields on the authneticator
  7. Click the dropdown arrow under Authentication Fields to choose the contact list field(s) you’d like the respondent to enter for authentication (you can add additional fields by clicking the green plus sign). You must use Email or External Data Reference.
    Qtip: The contact field used for authentication needs to contain unique values for each contact, such as an email or an ID number. If you authenticate based off of a common value like first name, the contacts with duplicate values will not be able to authenticate.
  8. If desired, type in a label to provide clarification on the contact field name.
  9. If you’d like to add another authentication field, click the plus sign ( + ). This can be any of the four options.
  10. If desired, click the Password checkbox to hide the characters the respondent types in.
  11. Select Prefill if applicable. See more in the Prefill Authenticated Fields section below.
  12. Click Options and review the Authenticator settings. See linked section for more details.
  13. Click OK to save the options.
    Options window
Warning: It is strongly recommended that you disable Save and Continue in the Survey Options if you are using an Authenticator. Additionally, sending your authenticated survey via the Individual Link can be redundant and will not double protect your survey. If you choose to distribute via this method, a respondent may be able to begin the authenticated section on different devices and then return and complete multiple responses.

Authenticator Options

Authenticators have a number of options for you to customize the authentication process.

Options window in an authenticator

Maximum Authentication Attempts

Enter the number of times a respondent can attempt to authenticate before they are skipped out of the authenticated section in your survey (if all of your survey is within the Authenticator, the respondent will be skipped out of the survey entirely).

Authentication Prompt Text

Change the text your respondents will see when prompted to authenticate by selecting a message from your library or creating a new one.

Qtip: Authentication messages are saved under General Messages in your Messages Library.

Authentication Error Text

Change the text your respondents will see when they fail to authenticate message by selecting a message from your library or creating a new one.

Too Many Failures Error Text

Change the text your respondents will see when they reach the maximum number of authentication attempts.

Allow authenticating respondents to retake authenticated section

Let your respondents complete the authenticated section more than once (i.e., they can finish the survey and then retake it).

Qtip: By default, respondents can authenticate only once. So if a respondent successfully authenticates and completes the survey, they will not be able to take the survey again.

Reload any previously saved progress upon authentication

Prevent respondents from starting multiple simultaneous survey sessions by reloading any saved progress each time they authenticate.

Warning: If you select this option, you must only have one Authenticator at the beginning of your Survey Flow. Also, it is strongly recommended that you disable Save and Continue in the Survey Options. Otherwise, a respondent is able to begin the authenticated section on different devices and then return and complete multiple responses.

Require respondents to authenticate again if they resume their session later

If a respondent has authenticated with this authenticator and then leaves the survey, they must authenticate with the same credentials again if they wish to continue the survey later. Authentication with the same credentials is required even outside of the authenticator flow branch. Respondent identifying info will not be captured again.

Qtip: Resuming on a later authenticator does not require re-authentication.

If a survey has multiple authenticators, the authenticator the respondent will have to log into again will be the last one that the user saw that has the Require respondents to authenticate again if they resume their session later option enabled.

Example: A survey contains two authenticators. The first has the Require respondents to authenticate again if they resume their session later option enabled, but the second doesn’t:

  • A respondent trying to resume before the first authenticator will not have to re-authenticate, because they haven’t authenticated yet.
  • A respondent trying to resume after the first authenticator will have to re-authenticate against the first authenticator.
  • A respondent trying to resume at the second authenticator will only have to authenticate against the SECOND authenticator.
  • A respondent trying to resume at any point after the second authenticator will have to re-authenticate against the FIRST authenticator.

Prefill Authentication Field

Prefill option on lower-middle of authenticator

The Prefill option allows you to auto-authenticate a user. This means that if they have the right credentials, they never even see the authenticator! They’re just logged right in.

There are two ways of distributing a survey with Prefill turned on:

In both cases, you still need to set up your contact list first!

The authenticator reads information saved in the emailed individual link or the query string and authenticates accordingly.

Setting Up your Survey Flow

If you’re using Prefill, you need to make sure you have the appropriate options selected in the Survey Flow.

Embedded Data element at top of Survey Flow above authenticator

  1. Add an Embedded Data element to the top of your Survey Flow.
  2. Make sure each field you’re using to authenticate is listed. Email is RecipientEmail and External Data Reference is ExternalDataReference.
  3. In the authenticator, choose what field to authenticate off of.
  4. Select Prefill.
  5. In the field, type out either RecipientEmail or ExternalDataReference.

Setting Up your Query String

If you would prefer to use a query string, you will still need to give each user their own unique link. (Unless there’s only one person in your contact list, and you have Allow authenticating respondents to retake turned on.)

  1. On the Distributions tab, copy your Anonymous Link.
    Anonymous Link in center of Anonymous Link section of Distributions tab
  2. Paste it into a Word Document, Google Doc, Notes app, or somewhere you can make edits.
  3. At the end of the survey link, add a question mark ( ? ).
    Anonymous link with query string added onto the end
  4. Type the Embedded Data name of the field you’re using to authenticate. For example, Email is wrong, but RecipientEmail is fine.
  5. Add an equal sign ( = ).
  6. Type the value of the field.
    Qtip: Email addresses contain special characters, such as the @ symbol and the period. Be sure to replace these with HTML URL encoding. There are guides and text to encoded converters online if you search “URL encoding.”
  7. Any additional authentication fields should be added with an ampersand ( & ) instead of a question mark.
Qtip: Need additional help troubleshooting your query string? Check out the Passing Information via Query Strings support page.

Removing an Authenticator

To remove the Authenticator, move all blocks out from under the Authenticator and only then click Delete. If you delete the Authenticator without moving the blocks so they are no longer nested underneath it, all the associated blocks will be deleted. If you accidentally delete your blocks, click Cancel at the bottom of your Survey Flow and all of the changes you made will not be saved.

If you accidentally saved after deleting your blocks, check out this page on adding blocks to the Survey Flow to get them back.

Testing with an Authenticator

If you are going to be testing out your Authenticator, make sure you add extra dummy contacts to your contact list so you can log in to the Authenticator yourself while testing. You might also want to enable Allow authenticating respondents to retake authenticated section in the Authenticator options so you can take the survey as many times as necessary (though be sure to disable it before you launch!).

If you don’t want to test the Authenticator itself, but the survey, you can bypass you authenticator by selecting Ignore Validation in the Survey Preview. Alternatively, you can wait to put your survey elements under the Authenticator until you are done testing.

FAQs