Skip to main content

Use the Unsubscribes section

Managing Unsubscribes in lemlist: A Quick Guide

Learning Objective

By the end of this guide, you'll understand the new Unsubscription System in lemlist, how to unsubscribe a contact from all channels or only specific contact details, where to review unsubscribe records, and what happens when unsubscribed contacts are used in campaigns.


What Is It?

The new Unsubscription System lets you block a contact from being reached on all channels with Do not contact, or only on specific contact details such as email addresses, phone numbers, or LinkedIn URLs.

Unsubscriptions are now managed at both:

  • Contact level – to fully block a contact from all outreach channels

  • Individual data level – to block only a specific email, phone number, or LinkedIn URL

This gives you more control and clearer traceability for every unsubscribe action.

A variable is one piece of contact information used to reach someone, such as an email address, phone number, or LinkedIn URL; “Unsubscribed from 3 variables” means three contact values were blocked and lemlist will no longer use them to reach that contact.


Why This Matters

Managing unsubscribes correctly is essential to remain a trusted and compliant outreach partner. This new system helps prevent prospects from being contacted again after they unsubscribe, even across multiple campaigns and channels.

Benefits of the new system:

  • Gives you precise control over unsubscriptions at both the contact and contact-detail level

  • Eliminates inconsistent behavior between channels

  • Improves visibility and traceability with centralized activity tracking on the contact panel

  • Supports future improvements for automatic opt-outs and stop-message handling on LinkedIn, SMS, and WhatsApp

  • Prevents bouncing an email from unsubscribing the whole contact unnecessarily

  • Reduces compliance risks, data inconsistencies, and manual workarounds for teams


How It Works

You can now unsubscribe a contact in two different ways:

  • Do not contact – blocks the contact across all channels

  • Channel-level unsubscribe – blocks only selected email addresses, phone numbers, or LinkedIn URLs

These unsubscriptions are reflected across contact records, campaign behavior, and team-level unsubscribe reporting.


Core Lesson: Using the New Unsubscription System

Phase 1: Open the Unsubscribe Settings

Step 1: Open Settings

Click your profile name or avatar in the bottom-left corner, then select Settings.

Open Settings from the profile menu

Step 2: Open the Unsubscribe section and review the page

In the left sidebar, click Unsubscribe. From there, you can review all unsubscribe records and use the available search and filter tools to analyze them.

In Team settings → Unsubscribes, both the button that opens the add form and the form’s submit button are labelled Add to unsubscribes. There is no direct CSV upload option. Exporting unsubscribes to CSV is available on the Email Pro plan and above; Export all to CSV downloads the file from the page and displays an “Exporting your unsubscribes, the download will start shortly” notification until the download begins.

Open the Unsubscribe section and review unsubscribe records

Phase 2: Manually Unsubscribe Variables

Step 3: Add variables to the unsubscribe list

Click Unsubscribe variables, then enter one value per line. You can add:

Placeholder values such as 0 can no longer be added to the unsubscribe list.

  • Email addresses

  • Email domains that must start with @

  • Adding a domain blocks outreach to matching email addresses, but does not prevent contact creation, importing contacts, or logging their emails. Avoid generic domains such as @gmail.com or @outlook.com, which would block every lead using those providers.

  • Phone numbers

  • LinkedIn URLs

Example values:

@domain.com

0612345678

https://linkedin.com/in/user

Enter unsubscribe variables in the modal

Step 4: Confirm the unsubscribe

After entering the variable or variables you want to block, click Unsubscribe variables.

Confirm variable unsubscription

Step 5: Verify the new unsubscribe record

Once saved, the unsubscribed variable appears in the list with its details and timestamp.

View the newly unsubscribed variable in the list

Phase 3: Restore Manually Unsubscribed Variables

Step 6: Select the variable and remove it

To restore a manually unsubscribed variable, select the checkbox next to it, then click Remove variables.

To re-enable a contact unsubscribed as a contact, go to the Contact section and remove that unsubscription. You can also remove unsubscribed leads from the list, remove those leads from the campaign, and relaunch the campaign for them. Unsubscribing blocks all emails to a contact, including manual Inbox replies; removing the contact under Settings → Unsubscribes restores the ability to reply.

Select an unsubscribed variable and remove it

Phase 4: Filter and Audit Unsubscribed Variables

Step 7: Filter records by date

Use Filter by date to narrow the list to a specific time period.

Filter unsubscribed variables by date

Step 8: Filter records by unsubscribe type

Use Unsubscribes types... to review the source of the unsubscribe, such as:

  • API

  • Not delivered (Bounced)

  • Lead

  • User

  • Abuse

View unsubscribe type filter options

Step 9: Filter records by variable kind

Use Filter by variable kind... to display only unsubscribed:

  • Email addresses

  • Email domains

  • Phone numbers

  • LinkedIn URLs

View variable kind filter options

Step 10: Filter records by user

Use Filter by user to identify which teammate performed a manual unsubscribe action.

Filter unsubscribed variables by user

Phase 5: Unsubscribe a Contact from the Contact Panel

Step 11: Open the unsubscribe action from a contact

From the Contacts page, open the contact record, click the actions menu in the top-right corner, and select Unsubscribe. This action is also accessible from the contact panel in other places such as tasks, inbox, and the Chrome extension.

Open the Unsubscribe action from the contact panel

Step 12: Choose what to unsubscribe

In the Unsubscribe contact modal, choose the type of restriction you want to apply:

  • Do not contact (from all emails & numbers) – blocks the contact across all lemlist channels

  • Unsubscribe email address(es) – blocks only selected email addresses

  • Unsubscribe phone number(s) – blocks only selected phone numbers

  • To unsubscribe a lead specifically from phone outreach, their phone number must be populated in their contact information. Deleting an incorrect phone number does not automatically remove upcoming call tasks, because tasks are generated from the campaign sequence.

  • Unsubscribe from LinkedIn – blocks only selected LinkedIn URLs

  • When someone opts out, unsubscribing their email and LinkedIn URL blocks those details from future imports and campaigns. To block a company across channels, unsubscribe each contact’s LinkedIn URL individually; you can filter contacts by company, export them, and add their LinkedIn URLs to the unsubscribe list one per line. Keep the company’s email domain on the list to block future email outreach to new contacts from that company. There is no separate workflow to stop all acquisition outreach; unsubscribing leads from the relevant channels is the way to prevent it.

If a contact has multiple emails or phone numbers, you can select exactly which values to unsubscribe.

Choose unsubscribe options in the contact modal

Step 13: Use Do not contact when you want to block all outreach

Select Do not contact when the contact should no longer be reached through any channel. When this option is enabled, the relevant fields are blocked for the whole contact.

Select Do not contact for a contact

Step 14: Review the result on the contact panel

After a full unsubscribe, the contact panel shows a banner confirming that the contact has been unsubscribed from all variables.

Banner showing the contact is unsubscribed from all variables

Step 15: Check the activity log for traceability

Open the Activities tab on the contact panel to see unsubscribe events and their source. This helps you track who unsubscribed the contact, when it happened, and whether it came from a user action, API, bounce, or another source.

Unsubscribing a contact does not delete their conversation history; it remains accessible in the contact’s Activities tab and the Inbox. Marking a lead Do not contact prevents future outreach through lemlist, but does not guarantee that an existing LinkedIn conversation will stop syncing.

View unsubscribe activity in the contact activity feed

Phase 6: Campaign Behavior for Unsubscribed Contacts

Step 16: Understand what happens in campaigns

If a contact is unsubscribed, lemlist prevents them from being contacted in the restricted channels.

Blocking a phone number stops SMS and WhatsApp steps to that number, while blocking a LinkedIn URL stops LinkedIn steps to that profile. Unsubscribing an email address, phone number, or LinkedIn URL stops campaigns for contacts using it as their main email, main phone, or LinkedIn URL. Campaigns continue running when the unsubscribed email or phone number is held only as a secondary email or in a phone custom field.

  • If a contact is marked Do not contact, they should not be contacted across channels

  • If only some variables are unsubscribed, the contact can still appear in a campaign, but the affected channels or values are blocked

  • If a contact becomes unsubscribed while a campaign is running, future restricted steps are skipped automatically

In the campaign lead list, unsubscribed contacts or values are clearly labeled.

Unsubscribed status shown in a campaign lead list

The lead status also appears as Unsubscribed in the campaign lead table.

An unsubscribed email appears greyed out, with a status notification when you hover over the email field. If the email is not greyed out and has no such notification, it has not been unsubscribed.

Unsubscribed lead status in the campaign table

What Problem Does It Solve?

This system prevents prospects from being contacted again after they unsubscribe, even if they appear in multiple campaigns, channels, or records.

It helps solve common issues such as:

  • A prospect being unsubscribed in one place but still reachable in another

  • Shared emails or phone numbers creating inconsistent contact behavior

  • Manual workarounds to stop outreach across channels

  • Missing traceability for compliance reviews


Important Notes and Edge Cases

  • If two contacts share the same email address or phone number, unsubscribing that value also affects the other contact using the same value

  • If an email bounces, the lead is automatically unsubscribed from email and can't receive emails again unless manually updated, while steps on other channels continue in multichannel campaigns.

  • A contact on a privacy or global unsubscribe list cannot be contacted through lemlist channels

  • If a contact is manually imported or added from the People Database and lemlist detects that they are Do not contact, campaign launch will still be blocked for that contact

  • When only some variables are unsubscribed, unrestricted steps in the sequence can still continue


Plans and Availability

  • Available on all plans


FAQs and Troubleshooting

What’s the difference between “Do not contact” and channel-level unsubscription?

Do not contact blocks the contact from being reached on all channels across all campaigns. Channel-level unsubscription blocks only the selected channel or contact detail, while leaving the others active.

Can I unsubscribe only one email address or phone number if a contact has several?

Yes. In the Unsubscribe contact modal, you can select only the specific email address, phone number, or LinkedIn URL you want to block.

If I unsubscribe a contact from one campaign, will it affect other campaigns?

Yes. Unsubscriptions apply globally across all campaigns, not only the campaign where the action was triggered.

What happens if a contact unsubscribes during a running campaign?

All future restricted automated steps are immediately skipped across campaigns. The lead can appear with an Unsubscribed status.

How can I see who unsubscribed, when, and why?

You can review unsubscribe actions in:

  • The contact’s Activities panel

  • Settings → Unsubscribe, where you can filter by date, type, variable kind, and user

Can I manage unsubscribes through the API?

Yes. Unsubscribe management is available through the API for both variable-level and contact-level unsubscriptions.

Did this answer your question?