Table of Contents:

Subsection Pages


What is a List in Ongage (AKA Contacts/Recipient/Members Database)?

List is a database of contacts. Each lists in your Ongage account is a silo database typically used for managing different Brands or Web Properties.You can also search for, import, add, export, unsubscribe, resubscribe and/or delete list members in this module.

What's the difference between using several Lists vs. using 1 List with Segments

  • Generally speaking, lists are siloed databases.

  • Segments are targeted audiences within the same list based on behavioral data (opens, clicks, post click conversions) and/or data points (e.g., demographics, such as country, region, gender, income bracket, etc.).

  • Campaigns, Analytics, imports, exports are operations performed on the list level.
  • See following subsection.

When is it recommended to use a List and when is it recommended to use Segments

  • Multiple lists are typically used for managing different brands, websites, or different companies (in the case that you're an agency) in which case each separate brand, etc. will be managed on a different Ongage list.

  • Moreover, multiple lists allows your subscribers to be active one list and unsubscribed from another. For example, lets say you have one list for email marketing of Jobs, and another for Real-Estate. By managing those on separate lists, a contact can be unsubscribed from one list, and yet active on the other one. 
  • A List with Segments allows creating highly targeted marketing audience (segments) for the same brand, website, etc. For example creating an audience of shoppers where (area_of_interest = apparel AND brand = Bloomingdales).
  • Also use segments when you want to segment your list by behavioral criteria, for example opened, clicked, did not open or clicked in the last X days. Post click data and/or external behavioral data can of course also be used, e.g., paying customers vs. non-paying customers, registered vs. on-registered, etc.

List Dashboard

The List → List Dashboard: provides you with an overview of your Ongage List (aka contacts DB) as to overall size, number of active contacts (aka members, subscribers), unsubscribed, etc.

About Domains Distribution aka Top Domains in List

  • The List Domain Distribution (aka top domains or top level domains) pie chart shows which are the top ISP/Mailbox provider domains (e.g.,,, etc.) that reside in your List.
  • That distribution is unrelated to sending, and only reflects which top domains reside in each of your lists. 
  • This pie will show the top 8 domains in your list plus all Others.
  • The breakdown can be different from list to list (and in the case of companies doing B2B marketing, the top level domains might be something like,, etc.).
  • The List overview data is updated and refreshed once a day.

How often is the List Dashboard Updated

The List Dashboard is updated several times a day, and therefore may not immediately reflect all of the very latest changes. Besides the cron job that runs several times a day, the List overview is updated after, any one of the following (though it may take a few minutes, from when the following operations are completed, till you see the update in the List dashboard):

  1. List import (since import is an asynchronous process, only after it is fully completed will you see the stats in the List dashboard) 
  2. Add member via UI or API
  3. Delete/Unsubscribe via UI or API

List FAQs

About Date Fields in Ongage

  • Internally Ongage stores dates in Unix Time according UTC .

  • When displaying dates in the UI it then renders that Unix Time according to the format settings of the list field and time-zone of the Ongage user.

What are Active and Inactive Contacts

  1. Active contacts are email addresses in your list that can be actively targeted and sent to, and do not have an inactive status of: hard bounced, unsubscribed or complained.

  2. Inactive contacts: hard bounced, unsubscribed and compliant are automatically deactivated by the Ongage platform and will never be sent to ever again by the Ongage system!
  3. Soft bounces are considered active and addressable email addresses. See our Delivery Glossary & FAQ for more info about that.
  4. You can view the number of Active contacts as well as the various Inactive contacts in any given list, in the List Dashboard, which you can find under the List menu:

What happens to contacts who unsubscribe, hard bounce, or complain

  1. Their status will automatically change to inactive by the Ongage platform and Ongage will no longer send emails to them ever (unless you resubscribe them). There is nothing you need to do to set this. This is how the system works out-of-the-box.

  2. Import, add/update member, or API add/update do not change their status, i.e., they will remain inactive.

Are hard bounces, unsubscribes and complaints inactivated per list or per account

  1. That depends on your List Manager Account Settings

  2. By default 'Unsubscribes' are set per list, while 'Hard Bounces' and 'Complaints' are set globally per account.
  3. To see or change these setting click on the upper right the Setting icon and choose the 'List Manager' option. 
  4. At the bottom of the page you will find the 'Deactivation Settings' section for handling 'Unsubscribes', 'Hard Bounces' and 'Complaints'.
  5. You may apply these options globally per the account or per list. 

How can I know if a member is active or inactive i.e., unsubscribed, hard-bounced, complaint

  1. If you want to search for the status of a single contact in a list, go to List >> Contact Manager >> Search.

  2. You can also check the status of single contact in multiple lists. To do so refer to the screenshot below.

(warning) Inactive members (hard bounced, unsubscribed and compliant emails) are automatically turned to inactive and will not be sent to ever by Ongage (unless you purposefully resubscribe them).

Can I copy the contents of an entire List to another List

  1. Not directly.

  2. The copy function in the "List > List Manager" will create a new list, with an exact copy of all the fields that were in the original one, but it will not copy over the members.
  3. You will need to export members from the old list and import them into the new list in order to copy over all list members.

What are the different ways to add new contacts to your Ongage List / DB

  1. Import your contacts using a CSV file. See the Import Your Contacts help page in our Getting Started Guide.

  2. Add contacts via the Ongage API:

    1. See our API FAQ Getting Started Guide:

      1. How to Add and Update Contacts to a List (via API).

      2. How to Issue an Import via the API (this is the same import as in point #1, just via API).

  3. With the Ongage Web registration form – see our Form Builder help page right here in this List section of the guide.

  4. Finally, you can also add single contacts from the List → Contact Manager → Add/Delete Contact tab.