Skip to main content

Contacts

Contacts (also called subscribers) are the individual email addresses stored in your lists. Each contact can have associated profile data, engagement history, and various status flags that determine how they interact with your campaigns.

Viewing Contacts

All Contacts View

Navigate to Contacts → View/Search Contacts to search and view contacts across all lists.

This view provides:

  • Add New button to add a single contact
  • Import Contacts button for bulk import
  • Bulk Actions dropdown for operations on selected contacts
  • Search box to find contacts by email, name, or other data
  • Filter dropdown to filter by list or other criteria
  • Column reorder button (≡) to customize displayed columns

List-Specific View

Navigate to Lists → Contact Lists, then click on the contact count to view contacts within that specific list.

Contact Information Displayed

The default columns shown are:

ColumnDescription
ContactAvatar, name, and email address
GroupThe list group
ListThe contact list name (clickable link)
Created onDate and time the contact was added
BouncedBounce status indicator (circle)
UnsubscribedUnsubscription status indicator (circle)
ConfirmedConfirmation status badge (e.g., "CONFIRMED")
ActionsAction menu (three dots)

Contact Actions

Click the actions menu (three dots) next to any contact to access:

ActionDescription
Contact DetailsView full contact information and custom fields
Email HistoryView all emails sent to this contact
EditModify contact details and custom field values
DeletePermanently remove the contact

Customizing Columns

Click the column reorder button (≡) in the top right to customize the display:

  1. Select which columns to show
  2. Drag and drop to reorder
  3. Save your preferences

Column preferences are saved per list.

Adding Contacts

Manual Entry

Navigate to Contacts → Add a Contact or click Add New from the View/Search Contacts page.

Contact's Details

The first section contains the core contact information:

FieldDescriptionRequired
Contact ListSelect the list to add the contact toYes
Email AddressValid email addressYes
FormatEmail format preference (HTML or Text)No
Confirmation StatusConfirmed or UnconfirmedNo
StatusActive or InactiveNo
BouncedNot Bounced, Soft Bounced, or Hard BouncedNo
UnsubscribedYes or NoNo
Email Validation

Invalid email formats will be rejected. Ensure the email address is correctly formatted.

Confirmation Status

If set to Unconfirmed, the contact may need to confirm their subscription before receiving campaigns, depending on your settings.

Custom Fields

Below the contact details, you'll see custom fields organized into groups:

Custom Fields (Default)

These are the standard profile fields assigned to the list:

  • Title
  • First Name
  • Last Name
  • Company
  • Country (dropdown)
  • State
  • City

Custom Fields (Unsorted)

Any additional custom fields that don't belong to the default group appear here:

  • Custom fields you've created (e.g., Company Staff Count, Industry)
  • Fields from other sources

Fill in the relevant fields based on the information you have for the contact.

Duplicate Handling

If you try to add a contact that already exists in the list, you'll see an error message:

"The contact [email] already exists in the contact list [list name]."

Each email address can only exist once per list.

Importing Contacts

Navigate to Lists → Import Contacts or click Import contacts from a list's action menu.

File Source

Select how to provide your contact file:

SourceDescription
Upload a CSV fileUpload a file from your local machine
Select a file from serverChoose a file already uploaded to the server

Click Browse to select a file from your computer.

Maximum File Size

The maximum file size for uploads is 250MB. For larger files, upload directly to the server and use the server file option.

Rocket Import

Enable the Rocket import toggle to significantly speed up the import process using multi-threading. This is recommended for large files.

Performance

Rocket import uses more server resources. For very large imports, consider running during off-peak hours.

Import Settings

Configure the following options for your import:

FieldDescription
Contact ListSelect the destination list. Click Create a List to create a new one.
FormatEmail format preference: HTML or Text
Confirmation StatusConfirmed or Unconfirmed
Contact StatusActive or Inactive
Includes header?Yes if your file has a header row (first row will be skipped)
File FormatCSV (comma-separated) or TXT (tab or custom delimited)
DuplicatesHow to handle existing contacts: Skip, Update, or Overwrite

Duplicate Handling Options

OptionDescription
SkipIgnore duplicates, keep existing data
UpdateKeep existing contact, update with new field values
OverwriteDelete existing contact, add new one

Field Mapping

After uploading your file, map the columns to the corresponding fields:

Your File ColumnMaps To
Column 1Email Address (required)
Column 2First Name
Column 3Last Name
...(other custom fields)
Email Column Required

You must map at least one column to "Email Address" for the import to proceed.

Import Process

Click Import to start the process. The import runs in the background, showing:

MetricDescription
Total RecordsNumber of rows in the file
ImportedSuccessfully added contacts
DuplicatesContacts already in the list
InvalidRows with invalid email formats
Background Processing

You can leave the page during import. The process continues in the background.

Import History

View past imports for a list:

  1. Go to the contact list
  2. Click Import History from the list actions menu
  3. Review import statistics and dates

Editing Contacts

  1. Navigate to the contact list or search for the contact
  2. Click the Edit icon next to the contact
  3. Modify the desired fields
  4. Click Save

You can edit:

  • Custom field values
  • Format preference
  • Status flags (Active, Confirmed, etc.)
  • Bounce status
Email Address

The email address cannot be changed. To update an email, delete the old contact and add a new one.

Contact Details

Click on a contact to view detailed information:

Contact Information

  • Email address
  • All custom field values
  • Creation date
  • Last update date

Email History

View all campaigns sent to this contact:

ColumnDescription
NameCampaign name
SentWhether the email was sent
BouncedWhether the email bounced
StatusDelivery status

Event Log

Track all events for this contact:

  • Email deliveries
  • Opens
  • Clicks
  • Bounces
  • Unsubscribes
  • Complaints

Bulk Operations

Selecting Contacts

  • Click individual checkboxes to select specific contacts
  • Use "Select All" to select all visible contacts

Available Bulk Actions

ActionDescription
DeletePermanently remove selected contacts
Set as Soft BouncedMark as soft bounced
Set as Hard BouncedMark as hard bounced
Set as Not BouncedReset bounce status
Set as ConfirmedMark as confirmed
Set as UnconfirmedMark as unconfirmed
Set as ActiveActivate contacts
Set as InactiveDeactivate contacts

Bulk Update

Navigate to Lists → Bulk Update to update contacts from a file.

How It Works

  1. Upload a CSV file with email addresses
  2. Select the target contact list(s)
  3. Choose an action to apply
  4. Process updates in bulk

Available Actions

ActionDescription
Delete selected contactsRemove contacts found in the file
Mark contacts as unsubscribedSet to unsubscribed
Mark contacts as subscribedRe-subscribe contacts
Mark contacts as soft bouncedSet bounce status
Mark contacts as hard bouncedSet bounce status
Set contact status to activeActivate contacts
Set contact status to inactiveDeactivate contacts
Mark contacts as confirmedSet confirmation status
Mark contacts as unconfirmedSet confirmation status
Set format to HTMLChange format preference
Set format to TEXTChange format preference

Progress Tracking

The bulk update shows:

  • Total records in file
  • Total records in contact lists
  • Records processed
  • Progress percentage

Contact Statuses Explained

Active vs Inactive

StatusCan Receive EmailsUse Case
ActiveYesNormal, engaged subscribers
InactiveNoTemporarily disabled contacts

Confirmed vs Unconfirmed

StatusDescription
ConfirmedSubscriber has verified their email (double opt-in)
UnconfirmedAwaiting confirmation

Bounce Status

StatusDescriptionImpact
Not BouncedNo delivery issuesNormal sending
Soft BouncedTemporary failure (inbox full, server down)May retry
Hard BouncedPermanent failure (invalid email)Excluded from sends

Subscription Status

StatusDescription
SubscribedActively opted in
UnsubscribedOpted out of this list

Suppression Status

StatusDescription
Not SuppressedNormal contact
SuppressedOn a suppression list (email, domain, or IP)

Contact Limits

Your account may have limits on:

  • Total contacts: Maximum contacts across all lists
  • Contacts per list: Maximum contacts in a single list

The current limit and usage appear in the interface.

Exceeding Limits

If you exceed your contact limit, imports will fail. Contact your administrator or upgrade your package to increase limits.

How Contacts Are Added

The system tracks how each contact was added:

SourceDescription
ManualAdded through the interface
ImportAdded via CSV import
WebformSigned up through a web form
APIAdded via API integration

This information helps you understand your list growth sources.

Deleting Contacts

Single Contact

  1. Find the contact in the list view
  2. Click the Delete icon
  3. Confirm deletion

Bulk Deletion

  1. Select multiple contacts using checkboxes
  2. Choose Delete from the bulk actions dropdown
  3. Confirm deletion
Permanent Deletion

Deleted contacts cannot be recovered. The contact's email history and engagement data may be retained for reporting purposes depending on your delete settings.

Best Practices

Data Quality

  • Validate emails on import: Catch typos and invalid formats
  • Use double opt-in: Ensure contacts want to receive emails
  • Regular cleaning: Remove bounces and inactive contacts
  • Maintain accurate data: Keep custom fields up to date

Import Tips

  • Test with small batches first: Import a few records to verify mapping
  • Use consistent formatting: Standardize date formats and text casing
  • Remove empty rows: Clean your CSV before importing
  • Back up before bulk updates: Export your list first

Engagement

  • Monitor bounce rates: High bounces indicate list quality issues
  • Track unsubscribes: Rising unsubscribes suggest content problems
  • Segment by engagement: Target active subscribers differently than inactive

Next Steps