You are browsing the documentation for version 1.6 of OroCommerce, OroCRM and OroPlatform, which is no longer maintained. Read version 5.1 (the latest LTS version) of the Oro documentation to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Available in OroCRM Available in OroCommerce

Marketing Lists

With the Oro application, you can automatically generate a marketing list of contacts that will be used for marketing purposes (mass call or mailing). For example, you can create a list of personal and contact details of customer users who registered after October 1 and whose shipping address is in California.

With marketing lists, you can run email campaigns in the Oro application. You can also synchronize Oro application marketing lists with subscribers lists in MailChimp and address books in dotmailer.

Marketing lists may be based on the contacts from the following items:

  • Accounts (via primary email of default contact)
  • Customer users
  • Quotes (via customer user email)
  • Orders (via customer user email)
  • Shopping lists
  • Business Customer
  • Lead
  • Contact

The way to create and manage contacts in a marketing list is described below.

Create Marketing Lists

To create a new marketing list:

  1. Navigate to Marketing > Marketing Lists in the main menu.

  2. Click Create Marketing List.

  3. In the General section, provide the following information:

    Field Description
    Name A name used to refer to the marketing list in the system.
    Entity Choose an entity from the dropdown. Only the entities that have contact details (E-mail or phone number) are available. Records of the chosen entity and entities related to it will be used to create the list of contacts.

    Chose the list type from the dropdown:

    • Dynamic lists are updated as soon as any changes have taken place in the system.
    • On demand lists will be updated only following the user request (click to refresh the table on the view page of the marketing list record).
    Owner Limits the list of users that can manage the marketing list to the users, whose roles allow managing marketing lists of the owner (e.g., the owner, members of the same business unit, system administrator, etc.).
    Description Free text to help you and other users understand the purpose or peculiarities of the list in the future.


    Custom fields may be added subject to specific business needs.

    A sample of a filled marketing list
  4. In the Filters section, define the Activity and/or Data audit and/or Field Condition and/or Condition Group filters that will be used to select the records for the list.

    More information about the ways to define filters is provided in the Filters Management guide.

    The contacts that match the filter condition will be automatically subscribed to the mailing list. You can later unsubscribe a contact or remove them from the mailing list.

  5. In the Columns section, define the set of fields that will be shown in the marketing list details on the general page for every target contact.



    Marketing activities require some contact information, so at least one column that contains it must be selected. A list of these fields is provided in the Designer section.

    For every column:

    • Choose the fields from the drop-down in the Column section.
    • Modify the label if necessary. By default, the field name is used.
    • Define the sorting order if you want the grid to be sorted by the value in this column.
    • Click Add.
    A sample of the columns set defined for the marketing list

    You can delete, edit, or change the column position by clicking the corresponding icon.

  6. Once you finish configuring the marketing list, click Save and Close in the top right corner.

Now, you can use contacts of your marketing lists to run dedicated campaigns.

Manage Marketing Lists

Navigate to Marketing > Marketing Lists in the main menu to be able to view the marketing list details, edit, or delete unnecessary marketing lists by clicking the corresponding icon.

The actions available for each marketing list from the grid

View Marketing List Details

To view the Marketing List details:

  1. Navigate to Marketing > Marketing Lists in the main menu.
  2. Click on the necessary marketing list to preview its contents.
The details page of the selected marketing list

Here, you can preview the details of users that will be contacted via the campaigns that are based on this mailing list. You can also manage the marketing list as described in the sections below.

Details provide you with the following insights:

  • A quick preview of the contact data — the columns added to the marketing list (e.g., when creating a marketing list).
  • TOTAL CONTACTED — the number of times a record of this marketing list was contacted within different email campaigns.
  • LAST CONTACTED — the date when a record of this marketing list was last contacted within different email campaigns.
  • SUBSCRIBED — status of the contact’s subscription. Initially, all the contacts in the list are subscribed (the column value is “Yes”). When after the email campaigns that were targeting the marketing list, a user has unsubscribed, the value changes to “No”, and the user is excluded from the following mailings.


When the same record is a part of different marketing lists, its data from other marketing lists will not affect the TOTAL CONTACTED and LAST CONTACTED values in the list you are viewing.

Manage Contact Subscription

To toggle the contact’s subscription to the marketing list:

  1. Navigate to Marketing > Marketing Lists in the main menu.
  2. Click on the marketing list to preview its contents.
  3. For the necessary contact, hover over the more actions menu and modify the contact’s subscription to the marketing list by clicking or .

When not subscribed, the person will not be contacted in the email campaigns.

Remove the Person From the Marketing List

To remove the person from the marketing list:

  1. Navigate to Marketing > Marketing Lists in the main menu.
  2. Click on the marketing list to preview its contents.
  3. For the necessary contact, hover over the more actions menu and click to remove the item from the list.

As soon as at least one item has been deleted from the marketing list, it is moved to the Removed Items section where you can view the contact details or restore the contact in the marketing list.

View deleted records in the Removed Items section

Share the Marketing List

To share the marketing list with other Oro application user:

  1. Navigate to Marketing > Marketing Lists in the main menu.
  2. Click on the marketing list to preview its contents.
  3. Click Share in the top right corner to open the Sharing Settings.
  4. Type in the user name next to the Share with text, or search for the necessary user: click , find the person you need, select the checkbox next to their name, and click Add.

You can preview the sharing status and see who you already shared the marketing list with. For this, click Share again.

To cancel sharing the marketing list with a particular person, click Share, and then click next to the user name. Use mass actions to cancel sharing for more than one user.

Synchronize a Marketing List with External System

As soon as Oro application has been integrated with a third party system, to which a marketing list may be mapped, you will see Connect to buttons with which you can, for example, map the list to subscribers lists in MailChimp or address books in dotmailer.

The Connect to buttons