ResourcesKnowledge Base

Manage recipient list

Mailing list management can be found under the menu item Recipients. Here you can manage all your mailing lists, update their content, view details about individual recipients including their complete history, search the lists and filter lists using queries.


Mailing list management

The recipient lists are divided under the following tabs:

  • Active – mailing lists that were updated or used in campaign in the last calendar month.
  • Unused – mailing lists that were not updated or used in campaign in the last calendar month.
  • Disabled – mailing lists that were manually disabled (using Disable button, which is located in the row for each list). No campaign will be sent to disabled mailing list.
  • All – all mailing lists available in the system.

Searchingicon is used to search for a specific recipient. As a result, an overview of all recipient lists in which the recipient was inserted is returned. After clicking on the icon, you can choose whether to search by email address (search by email address) or by mobile phone number (search by mobile phone number) stored in the “Mobile” field on the recipient's detail.

"Search" field

You need to enter the recipient's full email address/mobile phone number in the search field. You can use “*” to search by partial match – for example, on the basis of the entry * all recipients with a mailbox on will be searched, on the basis of the entry +420777* all recipients whose telephone number starts with +420777 will be searched.

Moving the mouse pointer to a line belonging to a particular campaign will display additional options for working with the list:087mleditEN.PNG

  • Enable/Disable – clicking the Enable/Disable button enables or disables the respective mailing list. You can not send any campaign to a disabled mailing list.
  • Delete – removes the mailing list from the system. Deletion will be permanent and along with mailing list, some statistical & historical data of recipients will be removed depending on whether the recipients exist in other lists or not.

Click thereporticon to display reports for a specific recipients list.

By clicking on theediticon, it is possible to edit the name and description of the recipients list.

The recipients list is opened by clicking on its name or on the number of recipients contained in it.

Creating a mailing list

088addmlEN.PNGA new list of recipients is created by clicking the button Add new list. A form will appear in which you will fill in the name of the new recipient list (name of the mailing list is public and may show up in automatically generated UTM tags for Analytics) and optionally its more detailed description (which is only visible in the platform). After clicking on the Save button the list will be created and individual recipients can be stored in it.


Try to keep a limited amount of mailing lists and do not create a new list for each campaign. In most cases one mailing list will be enough. For example if you have 2 country sites, have two lists – one for each country.

Keep in mind that campaigns can be sent to multiple mailing lists as well as subset of a list matching a delivery capping condition.

Managing recipients

Add recipient

A quality and maintained database of recipients is the key to success. There are multiple ways how to add recipients to mailing lists. It could be done automatically (recipient import), manually (inserting recipients one by one), but the most recommended method to automate mailing list recipient data updates is using data sources.

Recipient detail

You can save information (recipient data) for each recipient in the list, which you can then use in campaigns for personalization or segmentation. The data is divided into several groups on the recipient's card. The only required field is email.

Field Description Merge tag
Email recipient's email address (mandatory field) [EMAIL]
Reply-to allows to set an email address for replies - you can find more about setting up and using an address for replies HERE [REPLY_TO]
Phone recipient's phone number [PHONE]
Mobile recipient's mobile phone number (in international format, without spaces, e.g.: +44XXXYYYZZZ) - mandatory field if you want to send an SMS campaign to recipients [MOBILE]
Fax recipient's fax phone number [FAX]
Status cannot be manually set or edited, it is a system field  

Field Description Merge tag
Salutation optional salutation to the recipient [VOCATIVE]
Title recipient's title [PREFIX]
First name recipient's first name [FIRST_NAME]
Last name recipient's last name [LAST_NAME]
Nickname recipient's nickname [NICK_NAME]
Gender recipient's gender – values can be entered in the imported file or data source in different forms:
  • F/M
  • f/m
  • female/male

Field Description Merge tag
Company name of the company [COMPANY]
Address street [STREET]
ZIP postal code [ZIP]
City city [CITY]
Country country [COUNTRY]
State state [STATE]


In 25 custom fields ([CUSTOM1], [CUSTOM2],...., [CUSTOM25]) you can save important information about recipients, for example from your CRM system, which you can then use again for personalization or segmentation. It can be, for example, various dates (birthday,  date of first/last purchase,...), number of points in the loyalty program, level of the loyalty program, customer category, favorite categories/brands, and much more.

The content of custom fields is limited by the number of characters, custom field 1 ([CUSTOM1]) has a limit of 2048 UTF-8 characters, all other fields ([CUSTOM2]–[CUSTOM25]) can then contain a maximum of 255 UTF-8 characters. If a value exceeding the maximum limit of allowed characters is entered in custom field, it will be shortened to 2048 characters in custom field 1, or to 255 characters for other custom fields.

If the custom fields will contain a date that you then want to work with in the campaign (delivery capping), it must be inserted in one of the supported formats for custom fields  (date_us, date_us_short, date_us_md, date_eu, date_eu_short, date_eu_dm).

Custom field renamingCustom field names can be renamed. Just click the pencil icon on any recipient's detail tab to edit the field name. Renaming a field name will be reflected across the entire list of recipients.

The name of the custom field will also be named after the name of the given parameter in the case of importing recipients from data sources, or according to the column name in the case of importing from CSV / XLS.

Keep in mind that renaming custom field names can only make it easier for you to navigate the recipients detail tab and delivery capping filters. In the case of using custom fields in message content, conditions in the template, etc. it is necessary to still work with these fields as merge tags/variables in the [CUSTOM1] / [% recipient.CUSTOM1 -%] format .


Collected dataThese are values/data that have been obtained (if they have been clearly identified) based on measurements from tracked links in messages sent from Mailkit.





Field Description Merge tag
Continent continent (e.g. Europe) [GEO_CONTINENT]
Country country (e.g. Germany) [GEO_COUNTRY]
State/Region state or region (e.g. Baden-Wurttemberg) [GEO_REGION]
City city [GEO_CITY]
Operating system the operating system of the device on which the link was clicked [GEO_OS]
Browser the browser in which the link was displayed [GEO_BROWSER]


Manually adding recipients

recipient detailFirst, you need to open the list of recipients to which the new recipient is to be entered - either by clicking on its name or on theicon next to the number of recipients contained in it. After opening the list of recipients, click on the Add recipient button and the form for filling in the data about the entered recipient will be displayed.

This form contains all the information that may be available to the recipient on the system. These include personal information (such as name and gender), contact information (such as email and phone), address and up to 25 custom fields, which allow you to store all relevant information about the recipient to power your personalization and targeting.





Recipient status

Mailkit distinguishes 5 status types of a recipient.

  • Unknown (Unknown/Unknown)– the default status of the recipient in the mailing list. This status means that there is no single verified information about the existence of this recipient. Either no campaign has been sent yet or the recipient didn't read it or didn't click on any links.
  • Active (Active/Active)– recipient with an active status has a verified existence. The recipient either received an email and the hidden tracking image was displayed in his browser to provide proof of his existence or clicked on a link in the received email.
  • Unsubscribed (Unsubscribed)– the recipient has unsubscribed from the mailing using a link in email, marked email as spam or other method of unsubscribe has been used. No future campaign will be sent unless it would be a transactional message.
  • Temporarily undeliverable (Temporarily undeliverable/Temporarily undeliverable)– recipients with this status could not receive a message because their mailbox is temporarily out of service (but exists). Most common case reason for this status is a full mailbox. If the recipient is temporarily unavailable three times in succession, it will become permanently undeliverable.
  • Permanently undeliverable (Permanently undeliverable)– the recipient's mailbox is permanently out of service (does not exist). Mailkit no longer attempts to send any further messages to these addresses.

Recipient history

Cliking thehistoryicon in the recipient's row will display a complete recipient history for the last calendar year – information about all sent campaigns, their respective subject lines and content and the recipient's responses – whether the recipient opened the campaign, clicked links, type of user agent used, etc. The history of the recipient is related to the given list of recipients, i.e. the campaigns and their deliveries are displayed, to which the recipient list was assigned as a source.

Recipient history

Created: date of recipient record creation.

Last update: last time the recipient record has been updated (record can be updated using a data source, import, manual editing or by recipient's action in an email).

Consent date: date a consent has been recorded (if any).

Consent source:

  • N/A – consent not available
  • Subscribe – consent recorded via an API function mailkit.mailinglist.adduser
  • Subscribe (form) – consent recorded using standard Subscribe form.
  • Revalidate (form) – an unsubscribed recipient resubscribed using Subscribe form.
  • Link in mail – consent has been registered through a confirmation link in mail by a CONFIRM_URL function.
  • API revalidate – an unsubscribed recipient resubscribed using mailkit.mailinglist.adduser.
  • API 3rd party – consent has been recorded by a 3rd party and passed on using the mailkit.mailinglist.adduser function.

Last sent: date of last delivery to recipient.

Status: current recipient status.

By default, the history of the recipient (for the last year) is displayed, which is related to the given recipients list (Mail list history). By clicking on the "Complete recipient history" button, it is possible to view the complete history of the recipient (for the last year), i.e. in one window you will then get a complete overview of all messages sent to the recipient over the last year.

However, it is always necessary to keep in mind that business messages can only be sent to recipients from whom you have verified and verifiable consent (so-called double-opt-in) or to existing customers.

Mailkit can also generate subscribe forms that you can place on your website to allow visitors to sign up for your newsletters. In such case your signup process will be completely handled by Mailkit – from collecting the address, sending a confirmation email, tracking cofirmation and consent records to adding confirmed recipients to the lists.