Skip to main content
Loading...
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

Setting Up Session Capture


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!


Qtip: This page describes functionality that we intend to release starting May 14, 2025. Qualtrics may, in its sole discretion and without liability, change the timing of any product feature rollout, change the functionality for any in preview or in development product feature, or choose not to release a product feature or functionality for any reason or for no reason.

About Sessions Setup

On this page, we’ll walk you through how to set up session capture, so you can get the full benefits of Digital Experience Analytics. To start, go to Sessions, then Setup.

setup section of sessions tab

Attention: It is your responsibility to comply with all applicable legal requirements relating to your use of this feature, including, where required under applicable laws, obtaining any consent necessary from website visitors before enabling session recording, masking any personal data or other sensitive data in the recordings, and disclosing your use of Qualtrics in making and storing the recordings. For more information about data security and privacy, see Data Security & Privacy for Digital Experience Analytics.
Attention: Place https://*.qualtrics.com in the Content Security Policy header on your website to ensure sessions are recorded. Sessions will not be recorded if you do not have Qualtrics as an authorized domain.
Qtip: To track your organization’s session replay usage, see Digital Usage.

Session Capture

To begin recording sessions on your website, you need to enable Session capture.

switch that says session capture on / off

Qtip: If you receive a “Something went wrong” error after clicking “Save,” then session replay is not enabled for your license. A Brand Administrator must contact Account Services to request the feature.

This is the minimal setting you need to start using Digital Experience Analytics on your site. If this is all you want to do, you can save or activate your changes. However, we recommend checking out the other settings on this page to further enhance the experience.

Qtip: To connect session replay data with survey data, you have to add the fields “Q_SR_ID” & “Q_SR_PlaybackUrl” to your survey flow. See Viewing Digital Experience Analytics Data in a Dashboard for step-by-step instructions.

Recording and Consent

After turning on session replay, you have to decide if sessions will be automatically recorded when the page loads, or if explicit consent is required. Select your preferred option from the dropdown:

image of recording and consent settings

  • Record after users opt-in: Only record sessions after users provide their consent. This setting is selected by default.
    Attention: API is required for this option. You can also use the API to control which pages to record and when to start and stop the recording. See the Qualtrics API documentation for more information. See Integrating Consent Managers with Digital Experience Analytics for how to integrate with OneTrust, a common consent management provider.
  • Record when the web page loads: Begin recording sessions as soon as the web page loads.

You can also only record on specific pages by choosing on which pages to start, pause, and stop the recording. For more information, see Integrating Consent Managers with Digital Experience Analytics.

Masking

Masking allows you to hide input field data like usernames, addresses, and phone numbers from being seen in session replays. This is an important step to prevent users’ private information from being captured and shown in replays.

Attention: Masking is not retroactive. Once a session has been captured, elements will not be hidden if new masking rules are added.

When setting up masking, you have 3 options:

the different session masking options

  • Mask all content: By default, all text, images, and video will be masked. If desired, you can add CSS selectors for any elements you want to exclude from masking. See the “Elements included in Masking” subsection below for a list of elements that are masked by default.
    the mask all content option with CSS selectors

    Attention: If you want to prevent collecting unnecessary PII, choose this option. You can then selectively unmask any elements you are interested in. Any changes made to your website, including new elements added, may not be masked with this option. Always test your settings before publishing and after making changes to your website.
  • Choose what to mask: By default, all text entered into input fields will be masked. If desired, you can remove input field masking by disabling the Mask all input fields Additionally, you can add CSS selectors for any specific elements you want to mask.
    choosing what to mask and adding CSS selectors

    Attention: Since this option by default only masks input fields, some PII may not be masked if it is included on the page directly. Examples of this include an email address on the page as plain text and PII displayed in any profile boxes.
  • No masking: All content in user sessions, except for password fields, will be captured and shown in replays.
    choosing to use no masking

    Attention: If you select this option, all PII except for passwords will be visible in replays.

Elements included in Masking

When you select Mask all content, the following elements will be masked from your session replays:

  • HTML Tags: img, svg, video, object, picture, embed, map, audio
  • All inputs types
    Attention: Placeholder helper text displayed in input fields and background images that are part of the “style sheets” will not get masked, but you can hide them with CSS selectors.
  • All text

Test Sessions

Attention: You must enable 3rd party cookies in your browser to use test sessions.

Testing allows you to see how session replay will work with your latest saved changes. Before you can begin testing you will have to deploy the code snippet on your website.

  1. Select the session replay settings you want to test. You do not need to turn on session replay to run test sessions.
    Qtip: Recording and Consent and Sampling settings do not apply to test sessions.
  2. Click Save.
    section for testing session replay
  3. Within the Setup tab, scroll down to the Testing section.
  4. Select Enable testing. This adds the test session cookie to your browser.
  5. Navigate to your website to record a test session.
  6. A test session banner should appear on your website. Click Start recording to begin a new session.
    start recording option on your website
  7. Test your website, including clicking around, interacting with elements, and performing frustration behaviors.
  8. When you are done with your session, click Stop and exit recording to stop recording and end the session.
    button to stop and exit test session recording
  9. When you’re done testing, click Exit testing.
  10. Navigate to the Session Replay tab of your Website / App Insights project.
  11. Confirm there are sessions appearing in the Sessions list.
Qtip: It may take up to 30 minutes for new sessions to appear.

Sampling

Sampling allows you to only record a percentage of sessions. By default all sessions will be recorded. To enable sampling, select a sample rate from 1-100 to determine the percentage of sessions that will be recorded.

sampling rate options

Saving and Applying Changes

Attention: Make sure you’ve tested session replay before you turn it on.

When you make changes to any session replay settings, these changes must be saved or applied before navigating anywhere else within your project or account. If you leave the page without saving or applying your changes, all new changes will be undone.

image of setup tab with the save or discard changes options along the bottom of the screen

You can deliberately remove your edits by clicking Discard unsaved changes.

To save changes you’ve made without pushing them live to your website, click Save. This will save your configuration and allow you to use it in testing, but your changes won’t be applied to session replays or any dashboards using session replay data.

To apply changes you’ve made to session replays and any dashboards using session replay data, click Apply and activate.

Qtip: It may take several hours for dashboards to reflect these changes.

FAQs