Managing Contacts in a Mailing List

About Managing Contacts in a Mailing List

Once your contacts have been uploaded to a mailing list, you are welcome to edit their information, remove them from the list, opt them in and out, and much more.

Contact Information Menu

When you select a contact, a menu opens to the right containing information about them.

The information in the menu is almost exactly the same as the Contact Information Menu in the Directory Contacts tab, except where otherwise noted below.

Attributes

The Attributes section contains editable contact information and information. The Opted In status refers to whether the contact is opted into the mailing list, not the entire directory.

Changes made to the contact information will be reflected in the directory, too.

This section also contains Embedded Data saved to the contact. Here the values can be edited by highlighting or clicking into them.

Lists

This section only contains information for mailing lists other than the one you are viewing. For example, if you are looking at Mailing List 1 but the contact is also in Mailing List 2, then only Mailing List 2 will appear in this section. If the contact is only in Mailing List 1, this section will be blank.

Statistics

The Contact Stats section contains information on the number of times the contact has been sent invites, and when. This information only applies to invitations sent to this mailing list. If the contact belongs to another mailing list, those statistics will be excluded here.

Timeline

The Touchpoint Timeline only displays data for the contact for this specific mailing list. For example, if Dorothy’s in three different contact lists, and has been sent a different survey invite for each mailing list, only the selected mailing list’s invite and survey response will be shown.

Otherwise, this timeline works exactly as it does in the Directory tab, including the fact that it is inaccessible when you select multiple contacts at a time.

Contact Actions

Contact actions can be accessed by clicking the gear next to a contact’s name in the menu. You can also edit multiple contacts in the list by selecting contacts with the checkboxes along the left and then using the gear dropdown on the far-right.

Actions for a single selected user

• Edit: Edit the contact details, such as name, email address, and embedded data.
• Add to list: Allows you to add the selected contacts to or remove them from another list.
  Qtip: Looking to combine the contents of two lists into one? This is the best method for merging mailing lists.
• Remove from List: Remove selected contact from the mailing list. This contact will still exist in the directory.
• Opt-out of directory: Opt the contact out of the entire directory.
• Delete contact: Delete the contact from the entire directory.
  Warning: Deleting a contact will permanently remove it and its data from the directory. Any survey responses this contact has provided will not be deleted, but the response will no longer be associated with the contact. This cannot be undone.
  

Actions for multiple selected users

• Add to another list: Allows you to add the selected contacts to or remove them from another list.
  Qtip: Looking to combine the contents of two lists into one? This is the best method for merging mailing lists.
• Refresh Embedded Data: Because XM Directory contains every single contact in your brand, it can take some time for changes to embedded data to appear on the site. These changes will always load if given time, but if you notice that something isn’t showing up, you can refresh your embedded data to quicken the process.
• Edit Embedded Data: Edit embedded data.
  Qtip: Are you looking to add data collected from your surveys as embedded data to your contacts? Try using a contact list trigger.
• Opt-out of list / Opt-in to list: Opt the selected contacts in or out of the list. Contacts can be opted-out on multiple different levels. Visit this support page to see how these levels interact with each other.
  Qtip: When a recipient marks your email as spam, they can be opted out of the list, although they will not be opted out of the directory. See Avoid Being Marked As Spam for more details.
• Remove from List: Remove selected contacts from the mailing list. These contacts will still exist in the directory.

Attention: The tool icon to the left has similar options, but it doesn’t edit just your selected contact. It edits every contact in the mailing list. To only edit the contact selected, be careful to select the dropdown menu on the far-right!

Editing All Contacts in the Mailing List

The dropdown on the far-left allows you to export your contacts or edit every single contact in the list.

These actions include:

• Export Contacts: Allows you to export the entire mailing list.
• Add to Another List: Allows you to add all the mailing list’s contacts to or remove them from another list.
  Qtip: Looking to combine the contents of two lists into one? This is the best method for merging mailing lists.
• Refresh Embedded Data: Because XM Directory contains every single contact in your brand, it can take some time for changes to embedded data to appear on the site. These changes will always load if given time, but if you notice that something isn’t showing up, you can refresh your embedded data to quicken the process.
• Edit Embedded Data: Edit embedded data.
  Qtip: Are you looking to add data collected from your surveys as embedded data to your contacts? Try using a contact list trigger.
• Opt-out and Opt-in: Opt all contacts in or out of the list.
• Remove From List: Remove all contacts from the list. This will empty your mailing list. These contacts will still exist in the directory.

Importing Updates to an Existing List

Sometimes you may want to update contact information for many contacts all at once. You can update contact information in bulk by following the steps below:

1. In your contact list, click the wrench icon.
   
2. Select Export Contacts and export your contacts to CSV.
3. Open the CSV file on your computer.
4. In the file, edit the information you want to update and save your changes.
   
   Qtip: Do not change the values in the ContactID column! This field is used to identify the existing contacts. You cannot use ContactID to create new contacts. It may only be used to update existing contacts.
5. In your contact list, click Add List Contacts.
   
6. Select Upload a File.
7. Click Browse and select the file on your computer.
   
8. Use the Verify Fields window to check the correct contact fields are being imported.
   
9. Click Add Contacts.

Edit Embedded Data

One Contact

To edit the values of embedded data for a single contact, you simply click into a field and start typing. Then click Save.

Multiple or All Contacts

When you select multiple contacts at a time or use the select-all wrench on the left, you will select Edit Embedded Data or an embedded data value.

Once you do this, the Contact Details window will open.

1. Click into any value to change it.
2. Select a different contact field or embedded data to edit by using the dropdown or the arrows.
3. Save your changes by clicking Done.

Editing Contact Info Columns

You can change the default columns of contact information that are included in all mailing lists and in the directory.

1. Once inside the directory or a mailing list, click the edit icon to the right of the contact info columns.
   
2. Click the Rearrange Attribute icon to drag and drop columns.
   
3. Or, use the arrows to manually adjust the order of appearance.
   
4. Search and click fields on the left to add them to the list of columns you want to include.
5. Click X next to a field to remove it from the list of columns.
6. Click Save when you’re done.

Columns you can include

• Status: Whether the contact is opted into or out of the mailing list / directory.
• First Name and Last Name: The first and last name of the contact.
• Email: The email address of the contact.
• Reference ID: The External Data Reference column you filled out when uploading a mailing list.
• Language: The two-letter language code that specifies what language messages the respondent should receive, in the event you upload translations for your emails.
• Created: When the contact was first uploaded to the directory.
• Last Modified: When the contact was last modified.
• Phone Number: The phone number of the contact.
• Average Response Time: The average time it took the respondent to complete each survey invite they were sent, in minutes. This includes all responses they completed from surveys sent from mailing lists throughout the directory.
• Last Email: The last time an email was sent to this address. This includes emails sent to the contact from different mailing lists. Emails that were sent but bounced are counted, but emails that failed to send are not counted. This is the last email sent from any mailing list in the directory.
• Last Invite Received: The last survey invite (not reminder, thank you, or non-survey email) that was sent to this address. This includes emails sent to the contact from different mailing lists. Emails that were sent but bounced are counted, but emails that failed to send are not counted. This is the last invite sent from any mailing list in the directory.
• Last Response: The last survey response this contact completed. Only complete responses, not partial responses or responses in progress, are included. This is the last response sent from any mailing list in the directory.
• Response Rate: The percent of invites the contact is sent that they actually complete. The percentage is shown as a ratio, so 50% become 0.5. Only complete responses, not partial responses or responses in progress, are included. This is a directory-wide response rate, not just for survey responses sent from the selected mailing list.
• Total Emails: The total number of emails that have been sent to the contact from any mailing list in the directory. This includes invites, reminders, thank yous, and emails without survey links.
• Total Invites: The total number of invites (not reminders or thank you emails) that have been sent to this contact from any mailing list in the directory.
• Total Responses: The total number of survey responses the contact has completed, regardless of which mailing list in the directory the survey invitation was sent to.
• All embedded data listed in the brand

Pinning columns

You can pin a column to automatically move it to the top of the list.

1. Hover over the header of the column you want to pin.
   
2. Click the gear.
   
3. Click Pin Column.
4. Note how the column moves and is divided from the previous columns.
   

Removing columns

You can remove a column in the editor, but you can also remove a column by clicking the gear next to the header and selecting Remove Column.

FAQs