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

Email Distribution Management


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 Email Distribution Management

Once you have emailed survey invitations through Qualtrics, you will see a block with your distribution information and actions you can perform on them. Here you can view your distribution details, send Reminder and Thank You emails, cancel or delete distributions, and download the distribution history. These different options allow you to manage your email distribution and monitor progress.

Overview of Distribution Information and Options

Each time an email distribution is scheduled to be sent, it is recorded as a separate distribution block in the Emails section. Within each distribution block, you’ll find relevant information about the status of the distributed emails and surveys.

Email distribution settings

  1. Email to Contact List: The individual or contact list your distribution was sent to and the total number of contacts in the distribution.
    Qtip: In this example, the contact list has the date it was created in the name. This is unrelated to the date the distribution was sent / scheduled for.
  2. Sent On / Scheduled For: The date and time the distribution was sent. If the distribution has not yet been sent, the scheduled time will be listed in blue. The time zone will match the one set for your account.
  3. Emails Sent: The current number of emails delivered out of the total distribution.
    Attention: Occasionally, the distribution will show a larger number of Emails Sent than what shows up in the downloaded email history. This will happen when members of the contact list that were originally recipients have been deleted. Deleted contacts will not appear in the download, but deleting contacts has no effect on the Emails Sent statistic.
    Qtip: If you see a warning symbol next to Sent, some of your emails were not delivered successfully. This could be due to failed or bounced emails. See Distribution Statuses for more information on what each status means.
    warning symbol on an email distribution
  4. Emails Failed: The number of emails that did not leave our servers. The most common cause of a failed email is an incorrectly formatted email address, such as a missing @. This number does not include bouncebacks.
  5. Surveys Started: The number of surveys where the recipient has at least clicked on the link. This includes the number of people who have submitted the survey.
  6. Surveys Finished: The number of surveys sent out in the distribution that have been submitted.
  7. Emails Bounced: The number of emails that were rejected by the recipient server.

    Qtip: There are 2 types of bounces: hard bounces and soft bounces.

    Hard bounces are emails that can’t be delivered due to a permanent reason. This could include the email address not existing, the recipient server not accepting emails, or the domain not being a real email domain.

    Soft bounces are emails that can’t be delivered due to temporary reasons. The recipient email inbox could be full, the email could be too large, or the recipient email server could be temporarily down. Qualtrics automatically attempts to resend soft bounces several times and the time between attempts can vary. If the email still cannot be delivered, the email gets marked as a bounce.

  8. Duplicate Emails: The number of duplicate emails prevented from sending. Duplicate emails are emails with the exact same message and recipient as another email that went out. For example, if your contact list has the same email address on it multiple times, this will be seen as a duplicate, and to prevent your entire distribution from being flagged as spam, the Qualtrics mailer will not send these out. See the Editing Contacts in a List page for help consolidating duplicates in your contact list.
    Qtip: If you are sending repeated emails in different distributions, any emails that are identical must be sent out over 12 hours apart. Any identical emails sent to the same destination within 12 hours – even through different distributions – will be marked as duplicates and blocked.
  9. Complaints: The number of notifications Qualtrics servers receive from the email provider when a recipient clicks ‘Report Spam’ (or equivalent) for a Qualtrics originated email. See the Avoid Being Marked as Spam page for more details.
    Attention: Not all email providers send reports to Qualtrics servers, so the actual number may be greater.
    Qtip: Your email is more likely to be blocked or put in a spam folder if you are sending distributions to low-quality email addresses. Make sure you know who your recipients are.
  10. Actions Menu: When you click the dropdown arrow, you will see the following options:
    • Edit Distribution: This option only appears if you have scheduled your distribution to go out some time in the future. Edit your email message, your recipients, and more.
    • View DistributionThis option only appears if the email distribution has already sent. Here, you can take a look at the message you sent out, including any advanced options you selected.
    • Schedule Reminder: Schedule a reminder email to go out to your respondents who haven’t finished yet.
    • Schedule Thank You: Schedule a thank you email to go out to all finished respondents.
    • Download History: Download the links, link expirations, and status of all the email addresses in the distribution. See the Distribution Statuses page for a list of all the possible statuses and what they mean.
    • Cancel Distribution: This option only appears if the email distribution is scheduled for the future. This option cancels the distribution so it never goes out.
    • Halt and Delete Distribution: This option only appears if the email distribution has been sent, and is still in the process of sending. This gives you the opportunity to delete the distribution before it goes out. You only have as long as it takes the email to send before this option disappears.
    • Delete Distribution: This option only appears if the email distribution has already sent. Deleting a distribution deletes the links that haven’t been clicked yet.
Qtip: For more information on email statuses, such as emails sent, bounced, or failed, see the Distribution Statuses page.
Attention: Distributions older than three years are not available.

Standard vs. Compact View

All of the same information, including the dropdown of distribution actions, can be viewed in a more compact, list-like form. Use the icons in the upper-right to switch between the standard view and a more list-like view.

A gif of the hamburger icons in the upper-right. When the thinner lines on the right are clicked, the purple distributions disappear and are replaced with lists of contacts

Viewing and Editing a Distribution

Depending on whether your distribution has already been sent, you will be able to either view the message that was sent, or edit it before it goes out.

Viewing Sent Distributions

If your email has already been sent, you won’t be able to make any changes to it, but you will be able to see what contact list it went to, when it was sent, what message was used, and other settings you may have applied.

Click the dropdown menu on the right of the distribution block and select View Distribution.

Viewing your distribution

You will be able to view all details of the message sent, including the From and Reply-to Emails, the time it was sent, the subject, the message in its entirety, and any additional advanced options you set.

Attention: If you used a saved Library message in your email, but modified the message after the Distribution was sent, when you view the distribution, you will see the most recently saved version of the message instead of the message that was sent.
Attention: If you schedule an email with a Library message, and then delete the saved message from your library, the distribution will not send out, and you will receive an error. If you click on the distribution, you will see that the ‘Message has been deleted.’ You can delete library messages after the distributions are sent, but when viewing the distribution afterwards, it will still show as ‘Message has been deleted.’

Editing Scheduled Distributions

If your email hasn’t been sent yet, you can make any changes you like, such as updating the message, send date, recipients, or link type.

  1. Click the dropdown menu on the right of the distribution block.
    Distribution dropdown menu. First option is edit distribution
  2. Select Edit Distribution.
  3. Make your desired changes. For more details on these settings, such as link types, inline questions, and configuring custom “From” addresses, see Emailing Survey Invitations.
    Edit email window. Save in green, bottom-right
  4. Click Save.

Downloading the Distribution History

Attention: The ability to download the distribution history will be disabled if you set your email link type to Anonymous.
Attention: All users can download the distribution history of survey invitation emails. If you have access to XM Directory or the new contacts experience, then you will also be able to download the distribution history of reminder and thank you emails as well.

The distribution history is a list of all the recipients of a distribution along with the current status of each survey invitation and the individual link generated for them. This downloadable history allows you to investigate which specific recipients have started the survey, which have finished, and which are not receiving the survey invitation. You can download all of your distributions to one file, or you can download the history for a single distribution.

Qtip: The distribution history references the contact list to which the invitations were sent at the moment you download the history. If contacts were deleted after distributing the survey, the downloaded distribution history will not be accurate for the deleted contacts.
Qtip: The permission “Use Library Messages” needs to be enabled in the user settings in order to download distribution histories.
Qtip: Downloading the history generates links with statuses for respondents based on their status when the distribution was created. Re-downloading the history will refresh the statuses. If a list or segment has changed since the distribution was originally sent, and you’d like to make new personal links for the updated list or segment, you should create a new distribution.

Downloading the History for Multiple Distributions

Attention: This feature is available only on the new XMD Contacts Platform (COP). To gain access to this feature, please reach out to your Customer Success Manager.

You can download the distribution history for multiple distributions at once:

  1. Use the From and To filters in the top-left to select a date range of interest.
    choosing a date range and clicking download histories
Qtip: You must choose a date range to download distribution histories in bulk.
the download button is greyed out since no date range is selected
  • Click Download history.
  • A message will appear letting you know your download has started. Depending on the sizes of your distributions, it may take a while for this file to process. To access your download file, go to Downloads.
    navigating to downloads
  • Find your file in the list and click Download to save it to your computer.
    clicking download to save the distribution histories

This will generate a file containing the status of each recipient for all of the distributions of a survey. If you have access to XM Directory or the new contacts experience, then the option to Download History will allow you to download a file containing the status of each recipient in the distribution.

Attention: You can export a maximum of 10,000 distributions or a maximum of 1 million contacts in a single distribution history file. If your export is over this limit, your download will be split into multiple files.

The Downloads section contains the following information about your distribution:

the table showing distribution history exports

  • Channel: The type of distribution that is associated with each recorded response. See Distributions for a list of the possible distribution channels.
  • Distribution date range: This will show the selected date range for the distribution history export.
  • Date: The date that the distribution history was downloaded.
  • Status: The status of the distribution history download. Possible values include:
    • Success: The download was successful.
    • In Progress: The download is in progress. You will see a progress percentage in parentheses.
    • Partial export: If your download exceeds the size limit, it will automatically be broken into multiple download files. The “partial export” displays the full date range for your selected download. Below the partial export will be the multiple download files that make up your selection.
    • On hold: The download is paused. Click Resume in the Actions column to continue downloading.
      Qtip: Qualtrics will process up to three downloads at a time. If your export exceeds three download files (e.g., contains more than 30,000 distributions), then your additional downloads will be on hold, and you can resume downloading them once the initial three are completed.
    • Failed: The download couldn’t be completed. Try downloading the distributions again.
  • Actions: The distribution history file will be available in this column once the download is successful.
Qtip: In the Downloads tab, you can view any of the distribution history downloads from a multiple-distribution export.

The downloaded file for all distributions includes the following for each respondent:

Downloaded distribution history file

  • Distribution Id: The unique identification code assigned to each distribution. This will indicate which specific distribution the response is connected to.
  • Distribution Sent Date: The date and time the distribution was initially sent.
  • Directory Id: The ID for the directory used.
  • Response Id: The unique identification code assigned to each recorded response. This field will only be filled once the recipient has finished their survey.
  • Last Name: The recipient’s last name as it appears in the contact list.
  • First Name: The recipient’s first name as it appears in the contact list.
  • Contact Id: The ID for the contact on a directory level, regardless of mailing list.
  • Lookup Id: The ID of a specific contact in a specific mailing list.
  • Transaction Id: If this distribution is part of a transaction batch, this field will list the transaction ID.
  • External Data Reference: The recipient’s External Data Reference, as it appears in the contact list. This is not a required field.
  • Email Address: The recipient’s email address.
  • Channel: The type of distribution that is associated with each recorded response. See Distributions for a list of the possible distribution channels.
  • Message Type: The type of message sent to the recipient. This field will tell you whether the response is associated with an invite, reminder, or thank you. For more information, see Email Distributions and Reminder & Thank You Emails.
  • Status: The current condition of the respondent’s survey invitation. See the Distribution Statuses page for a list of all the possible statuses and what they mean.
  • Bounce Reason: If the email bounced, this field will include the reason that the email bounced.
  • Sent to: The email address the distribution was sent to.
  • Contact Frequency Rule Id: The internal ID of the contact frequency rule, if in effect for this distribution.
  • Exceeded Contact Frequency: Indicates if the distribution exceeded the contact frequency rules for the contact. This field will have a value of either TRUE (distribution exceeded contact frequency rules, therefore the contact did not receive the distribution), or FALSE (distribution did not violate any contact frequency rules).
  • End Date: The date and time the recipient finished the survey.
  • Link: The recipient’s personal survey link. The download distribution file will contain the exact links that were sent to survey recipients.
  • Link Expiration: The date and time the recipient’s survey link expires (for those who have not finished the survey).
    Qtip: Even if this link hasn’t expired, you may notice a link is not working due to the response expiring under the incomplete survey settings or the survey availability date.
Qtip: The times in this file are presented in the UTC time zone and format, rather than matching the time zone selected in your account settings.

Downloading the History for One Distribution

To download the distribution history, go to the dropdown menu to the right of any distribution block and choose Download History.

Purple distribution, arrow to right, download history option second to last

You can also view the Distribution History for Reminder and Thank You emails. If your Reminder or Thank You emails have been sent, you can see the distribution statistics to the right and the send time to the left. In addition, you can see what message was sent by clicking on the dropdown and choosing View Distribution. If you have access to XM Directory or the new contacts experience, then you will also have the option to Download History which will allow you to download a file containing the status of each recipient in the distribution.

Attention: Distribution histories for Reminder and Thank You emails only contains the email’s send status. It is not possible to determine whether a survey response came from an invite or a reminder link.

a reminder email distribution that's been expanded to see that stats and history for the distribution

The distribution history for survey invites includes the following for each respondent:

  • Response ID: The unique identification code assigned to each recorded response. This field will only be filled once the recipient has finished their survey.
  • Last Name: The recipient’s last name as it appears in the contact list.
  • First Name: The recipient’s first name as it appears in the contact list.
  • External Data Reference: The recipient’s External Data Reference, as it appears in the contact list. This is not a required field.
  • Email: The recipient’s email address.
  • Status: The current condition of the respondent’s survey invitation. See the Distribution Statuses page for a list of all the possible statuses and what they mean.
  • End Date: The date and time the recipient finished the survey.
  • Link: The recipient’s personal survey link.
  • Link Expiration: The date and time the recipient’s survey link expires (for those who have not finished the survey).
    Qtip: Even if this link hasn’t expired, you may notice a link is not working due to the response expiring under the incomplete survey response settings or the survey availability date.

If you have XM Directory, your export will contain the following additional fields:

  • Contact Id: The ID for the contact on a directory level, regardless of mailing list.
  • Lookup Id: The ID of a specific contact in a specific mailing list.
  • Transaction Id: If this distribution is part of a transaction batch, this field will list the transaction ID.
  • Contact Frequency Rule Id: The internal ID of the contact frequency rule, if in effect for this distribution.
  • Exceeded Contact Frequency: Indicates if the distribution exceeded the contact frequency rules for the contact. This field will have a value of either TRUE (distribution exceeded contact frequency rules, therefore the contact did not receive the distribution), or FALSE (distribution did not violate any contact frequency rules).

Canceling or Deleting a Distribution

Each distribution gives you the option to either cancel or delete it, depending on the distribution status. For distributions that have not yet sent, you have the option to cancel and delete the distribution. For distributions that have already been sent, you have the option to remove the distribution record from your Emails section. If a distribution has already sent, then deleting the distribution will not remove the email you have sent from recipients’ inboxes.

Deleting the distribution will prevent individual survey links that have not yet been clicked on from being accessed. (Anonymous and multiple completes links are unaffected.) It will also remove the option to send reminder and thank you emails.

Warning: Be careful when deleting distributions. Once a distribution is deleted, it cannot be restored. That includes any unclicked links that were deactivated when the distribution was deleted.

To cancel or delete a distribution, open the dropdown menu to the right and select Cancel and Delete Distribution or Delete Distribution.

Top is a scheduled email. When you click the dropdown , the option is cancel and delete distribution. The bottom was already sent. The option is to delete the distribution

Qtip: Deleting a distribution will not reduce the Audience Size.

Halt and Delete Distribution

The Halt and Delete Distribution option only appears if the email distribution is currently Sending (see screenshot below), meaning you clicked Send, but the distribution hasn’t arrived at the recipients’ inboxes yet. This gives you the opportunity to delete the distribution before it goes out. You only have as long as it takes the email to send before this option disappears.

Distribution says it is sending... Dropdown has halt and delete option at the bottom

Enabling Distribution Health Notifications

Attention: This notification is enabled at the user level; any user wanting to receive a distribution notification for a specific survey will have to enable this feature within their own account.

Distribution health notifications allow you to receive a weekly email summary of all recent email distributions sent for a particular active survey, including reminder and thank you emails. This can be useful to see an overview of how effective your distributions are, and if there is anything you can do to improve them in the future. Notifications are sent on Tuesday mornings, and contain data from the previous week (Monday to Sunday).

Qtip: This notification is only sent for active surveys; if your survey is no longer active you will stop receiving a weekly email.
Qtip: Notifications will be sent to the email address associated with your Qualtrics user account.

Follow these steps to enable distribution notifications for a survey:

  1. Navigate to the survey you want to enable notifications for.distribution health button within a survey distribution
  2. Go to the Distributions tab.
  3. Select Emails.
  4. Turn on Get a weekly email summary of messages sent, failed and bounced.
  5. Repeat these steps for every survey you want to track the distribution metrics for.
    Qtip: If you have distribution notifications enabled for multiple surveys, you will only receive 1 email with metrics for all the surveys you are subscribed to.

The weekly summary displays how many emails with survey invitations were sent, failed or bounced in the last week, as well as the bounce rate and how it compares to the average for a given survey.

distribution health email

To unsubscribe from these notifications, turn off the setting within the Distributions tab or click Unsubscribe at the bottom of the email. Unsubscribing will stop you from receiving this notification for all surveys at once.

Additional Troubleshooting Resources

If you have questions about email deliverability, please make sure you also consult the following pages:

  • Troubleshooting Email Distributions: A guide to improving email deliverability.
  • Email Distribution Error Messages: Qualtrics has built in messages to let you know what you need to do to successfully send your emails. The errors described on this page occur for survey invitations, reminders, and thank you emails.
  • Avoid Being Marked as Spam: If you find that your emails from Qualtrics are consistently being marked as spam, there are a few things you can do to prevent this.
  • Using a Custom “From” Address: The email address you use to send email messages from Qualtrics has a large effect on your email deliverability and open rates. Using your own custom email address requires careful setup to ensure the best email deliverability possible.
  • Finding Qualtrics IDs: Visit this page to learn how to find the ID of a distribution if you need the ID for troubleshooting or to use with the Qualtrics API,

FAQs