Help Documentation

Static Lists

Updated on

Static Lists consist only of contacts you have accrued up until the point when you create the list, and they remain unchanged unless new contacts are manually added or existing contacts are removed. 

How to Create a Static List

  1. Navigate to Contacts > Lists.
  2. Enter your list name in the Create New List text area.
  3. Select Static List for the content type and click Create.
  4. Fill in the Properties details.
  5. Click Continue - this takes you to the Member List view.

Properties

The table below lists the Static List configuration properties with their descriptions.

Field Description
Name This is the name of the Static List. This field is required.
Description This field allows you to add additional details about the list. This field is optional.
Folder Location This field shows the list folder in which the file is stored. A different folder can be selected by clicking on the magnifying glass.
Permissions This allows you to decide if you want the list to appear on the iPost subscription form.  

  • If Private is selected, the list will not appear on the subscription form.  
  • If Public is selected, the list can be configured to appear on the subscription form.

Members List

The Members List is where you can access the contacts associated with the list as well as different list functionality. On this page, you will see the contacts and any attributes associated with the contact. To see details on a specific contact, click on the email address for the contact and it will open a new window with that contact’s information.

  • Member Information: Edit attribute information for that contact.
  • List Membership: See all lists associated with the contact. You also have the option to add the contact to a new list, remove the contact from a current list, or to change the list membership status.
  • Custom Table Membership: View any data table(s) associated with the contact.
  • History: View email history for the contact. The email history consists of emails that have been sent to the contact and any other previous actions.

List Stats

List Stats provide contact metrics for the specific list.

  • Active: Total number of contacts that are available to be sent to.
  • Bounces: Total number of contacts that have bounced.
  • Unsubscribes: Total number of contacts that have opt-out globally and from the specific list.
  • Complaints: Total number of contacts that a complaint has been received from.

List Functionality

Within a static list, there are various functions available to you that will allow you to manipulate the data within the list. These functions are icons located on the right hand side above the contact information.

Upload

Upload allows you to import an outside list. The uploaded file must be a .CSV file and the file size must not exceed 50MB. To upload an outside list, follow the steps below.

  1. Click on the Upload icon.
  2. Click within the File Name field to browse your computer for the list that will be uploaded.
  3. Select the Delimiter of the data file that will be imported.
  4. Select the Members Operation.
    • Overwrite existing members - Replace the current list membership with the contacts in the data file.
    •  Only update existing members - Only update contacts in the list membership that are also found in the data file. New contacts will be rejected.
    •  Add only new members - Only add new contacts found in the data file that currently are not part of the list membership.
    • Add new & update existing members - Update contacts currently in the list membership and add any new contacts to the list membership. This is the default behavior for list imports.
  5. If you would like to receive an import summary, check the box next to Send a Data Upload Summary Report and enter your email address in the email box.
  6. Click the Upload button.
  7. On the Map Member page, map the fields from the outside list to the available attributes. If you do not want to import a specific field, then select the Ignore This Column option. The only required field for an upload is the Email Address field. Once the mapping is complete, click Finish Upload.

Add Members

Add Members allows you to add members by typing or copying in email addresses. To add members, follow the steps below.

  1. Click on the Add Members icon.
  2. On the Manually Add Members page, enter up to 20 email addresses in the text box. Each email address must be on its own line.
  3. Once finished, click the Upload button.

Run Special Query

Run Special Query allows you to select a predetermined query to run on the list.

Split

Split allows you to split a current list into multiple lists.

  1. Click on the Split icon.
  2. On the Split List page, select the number of branches you would like the list to be split. The default number of branches is 2.
  3. Select the methodology you would like to use in order to divide the contacts into the new branches.
    • Numbers - split the list by a specific quantity per branch.
    • Percentage - split the list by a percentage per branch.
  4. In order to distribute the contacts into the new branches, slide the blue circle for each branch until the correct quantity or percentage is reached.
  5. Select if you would like to remove the contacts from the current list after splitting the list.
  6. Select if you would like carry over the list level opt-in/out status to the split lists. 
  7. Enter the naming convention for the new list names. This field is optional and if nothing is entered, the default naming convention uses the name of the current list and appends an A, B, C, etc.  and a date/time stamp to denote the splits.

Merge

Merge allows a user to merge multiple lists together to create a new list. To merge lists, please follow the steps below.

  1. On the Merge Lists page, select the lists that are to merge by clicking in the Select Source Lists box. This will allow you to search for the lists to be merged. To select a list, click on the name of the list.
  2. Once your lists are selected, click Select.
  3. Select if you want to remove the contacts from the selected lists upon the merge. The default option is no.
  4. Click the Merge button.

Deduplicate

Deduplicate allows you to remove duplicated email addresses from multiple lists.

  1. On the Deduplicate Lists page, select the lists you would like to deduplicate by clicking in the Select Filter Lists box.
  2. Once the lists are selected, click on Select.
  3. Chose what you want to do with the duplicate email addresses after the deduplication is finished.
    • Selecting No will not save the duplicate email addresses.
    • Enter the name of a new list if you want the duplicated email addresses in a new list.
    • Select a current list if you would like the duplicated email addresses to be added to a current list.
  4. Click on Deduplicate.

Export

Export allows you to export the current list to your FTP.

  1. Click on the Export icon.
  2. On the Export List page, select the File Options.
    • Include column headers as the first line - output a header on the exported file.
    • TSV file format - export the file as a tab separated delimiter which will open in excel for an easier visual review of the file.
    • CSV file format - export the file with a comma separated delimiter which will open in a .txt file.
    • Pipe delimited file - export the file with a pipe delimiter.
    • Custom delimiter - allows you to assign the delimiter for the export file.
  3. Select the export type.
    • Download List and Contact Data - download all contacts in your list regardless of bounce status.
    • Download Bounced Contacts - only download those contacts with a bounce status.
  4. Choose if you would like to include opted out contacts in your export. By default, this option is checked.
  5. Select any additional attributes you would like exported with the contact email addresses.
  6. Select if you would like any Subscription Status field exported.
  7. Select any Subscription Topics you would like exported.
  8. Click Export after your selections are completed.
  9. The Send a Data Export Summary Report To field will default with your email address. This can be change to another email address if needed.
  10. Click Done to finish the list export.

Once the export is available, you will receive an email with with the name of the list and folder that it housed in on your FTP site.

Clean

Clean allows you to remove contacts from a list.  Once removed from a list, they will no longer be present on the list. However, the contact will still be included in the All Contacts and any other lists that they exist in.

  1. Click on the Clean icon.
  2. Select which contacts you would like removed from the list.
    • Remove all addresses from the list - empty the list completely of all contacts.
    • Purging all the opt-outs from this list - remove any contact with a global status of opt-out from the list.
  3. Click on the Clean button.
  4. The UI will confirm the contacts to be removed.
  5. Click on Empty to remove the contacts.

Search allows you to search for a contact.

  1. Click on the Search icon.
  2. On the Search Members page, select the attributes you would like to search. This field is populated with Email Address by default.
  3. Enter the text you would like to search.
    • Search for changed addresses - search on those addresses that have recently been changed via the native subscription center.
    • Perform fuzzy matching - search on a partial value contained within a field.
    • Search through all contacts - search on all contacts that reside on a list, including the All Contacts list, within your account.
  4. Click on Search to complete your search.

Once your search is completed, the results of the search will appear on the Search Members list.  To view the details for a specific contact, click on the contact’s email address.

Schedule & Send

The Schedule & Send button allows you to configure an email send from the list. When scheduling an email from a list, the list information is defaulted on Step 2 of the email schedule configuration page.

Modifying a List

To modify a list once it has been created, simply click on the name of the list to access the list details or the contacts for that list.

Previous Article Test Lists
Next Article Dynamic Lists