Guide to Unsubscribes in Klaviyo

Last updated at:


Learn how to allow contacts to unsubscribe, how to manually unsubscribe contacts yourself, and how unsubscribes are treated in Klaviyo.

When a contact is unsubscribed, they become suppressed in Klaviyo. Learn more about suppressed profiles.

Add an Unsubscribe Link to an Email

To add a basic unsubscribe link, use the following Klaviyo tag: {% unsubscribe %}

You can place this unsubscribe tag directly in your template. By default, the {% unsubscribe %} tag will populate as an unsubscribe link in your email with the text "Unsubscribe." If you want to customize the text in the link, this tag takes an optional parameter that allows you to customize the text. 

If you need even more control, there is also a tag that provides only the URL for the unsubscribe link. All three options are shown here:

{% unsubscribe %} Unsubscribe
If you'd no longer like to receive emails, {% unsubscribe 'click here' %} If you'd no longer like to receive emails, click here.

This is a fancy <a href="{% unsubscribe_link %}">unsubscribe</a> link.

NOTE: You will need to paste this into the source within the text block, rather than just pasting it into a text block. 

This is a fancy unsubscribe link.

When someone clicks an unsubscribe link that follows any of these formats, that click will not count towards your email's click rate. 

Manually Unsubscribe an Email from Klaviyo

Unsubscribe One or More Emails from a List

  1. Navigate to the list you want to unsubscribe profiles from
  2. Click the Manage List dropdown
  3. Select List Suppressions
  4. Click Add Email Address in the upper right
  5. Add the email address of the person you wish to suppress
  6. Select Add Email Address again in order to finish manually suppressing the profile

View How a Profile Was Suppressed

From the List Suppressions page you can filter profiles based on whether they unsubscribed on their own (Unsubscribed) or were added manually (Manually Added).

Reasons why you'll see contacts on your suppression list include the following:

  • The person unsubscribed
  • The person marked an email of yours as spam
  • Emails to this person hard bounced or soft bounced
  • You or someone else on your account manually added them to the suppression list


Unsubscribe One or More Emails Globally

To manually unsubscribe someone from all emails sent by Klaviyo:

  1. Navigate to the Profiles tab
  2. Select Suppressed Profiles in the upper right-hand corner of the screen
  3. Choose whether you want to suppress a single profile or bulk suppress many profiles
    1. To suppress a single profile, click the Add Email Address button
    2. To bulk suppress contacts, use the Upload File button
      •  Bulk suppressing contacts is permanent, and cannot be undone

Share a Global Unsubscribe Link with a Profile

  1. Navigate to your Account > Settings 
  2. Click into the Email tab
  3. Find the section labeled Consent 
  4. Copy the global unsubscribe link, which can be used to globally suppress contacts
  5. Share this link with someone or include it in an email

When someone then clicks the link, they can globally unsubscribe themselves from all of your future emails.


Unsubscribe vs. Update Email Preferences

In all of your emails, we recommend also including a direct link to update email preferences in addition to an unsubscribe link. This is a separate link — generated by the manage preferences tag, {% manage_preferences %} — that will take the recipient to a page where preferences can be updated.

When someone attempts to unsubscribe, it's possible that they may actually just want to receive fewer emails from you. By allowing your subscribers to choose how often they'd like to hear from you, you can lower unsubscribe rates.

While it isn't possible to turn an unsubscribe page into a preferences form, you can add an update preferences link to your unsubscribe page — we support the same manage preferences tag syntax in the text box on this page. This way, you may stop some would-be-unsubscribers from unsubscribing completely.

List-Specific vs. Global Unsubscribes 

When a recipient unsubscribes from an email you send, they will be suppressed for all future emails, regardless of which list(s) the message is sent to. If you have a paid Klaviyo plan, you can adjust this behavior on the account level or for specific lists. When the global unsubscribe setting is disabled, those who unsubscribe from a list-based send will only be suppressed from the list (or lists) that message was sent to, and may still receive messages sent to other lists they have subscribed to. 

To maintain strong deliverability and avoid recipients marking your emails as spam, Klaviyo highly recommends that you leave global unsubscribes enabled. 

To disable global unsubscribes for a single list: 

  1. Select your list from the Lists & Segments tab
  2. Open that list’s Settings
  3. Uncheck the option When someone unsubscribes from [LIST NAME], unsubscribe that person from all future emails
  4. Click Update List Settings


To disable this setting for all lists:

  1. Navigate to Account > Settings 
  2. Click Email
  3. Select Unsubscribe Behavior
  4. Uncheck the option When someone unsubscribes from a list, unsubscribe that person from all lists
  5. Click Update Email Tracking Settings


Learn how to remove suppressed profiles from a list.

When Someone Unsubscribes and Re-Subscribes

Whenever someone unsubscribes from your emails, they become globally suppressed (unsubscribed from all lists) in Klaviyo. This is because when contacts choose to unsubscribe from one of your emails, they typically expect to unsubscribe from all of them. However, contacts can resubscribe and be re-added to your list.

A contact can resubscribe by: 

  • Filling out a Klaviyo signup form or subscribe page 
  • Filling out a form that relies on Klaviyo’s V2 Lists API endpoint (either a third-party form, or a form built by your developers)

If you manually upload someone’s profile information or they resubscribe via a source that doesn’t rely on the V2 Lists API endpoint, such as a Facebook ad or certain third-party form tools, it will not mark them as unsuppressed in Klaviyo and you cannot email them. 

If a suppressed customer subscribes at checkout (e.g., by checking the "Accepts Marketing" option in a Shopify checkout), they will not be resubscribed. 

Note the following:

  • If someone is globally suppressed and then resubscribes to the same list they previously unsubscribed from, they will be re-added to that list
  • If someone is globally suppressed after unsubscribing from List A and then subscribes to List B, they will not be resubscribed to List A
  • If someone unsubscribes from an event-based flow, then subscribes to List A, they will be added to List A (as long as they resubscribed through a Klaviyo form or supported third party form) and begin receiving future emails
  • If someone is globally suppressed after unsubscribing from a list and is later imported via a list into Klaviyo, they will remain suppressed as importing does not qualify as someone resubscribing

Note that Klaviyo does not store information from a previous email service provider (such as Mailchimp) around when a profile unsubscribed from emails sent via the previous platform. We will only track when someone unsubscribes from a Klaviyo email.

Manually Unsuppress a Profile

If a former subscriber contacts you directly and asks to be re-added to your mailing list, you can manually unsuppress them. To do so: 

  1. Navigate to their profile in Klaviyo 
  2. In the Channels section, click Remove next to their suppression reason 



There is no way to remove suppressions from multiple profiles at once. 

SMS Unsubscribes

Manually Unsubscribe an SMS Number 

  1. Navigate to the Profiles tab or search by name or phone number. Click the recipient who you want to remove SMS consent for.
  2. On the right-hand side, locate Channels. Under the phone number, click Show consent details to show additional information.
  3. Click the Unsubscribe from SMS link. Confirm your choice in the modal that pops up.

  4. Note the red X next to their phone number, which indicates they are no longer consented to receive SMS marketing.

Unsubscribe SMS Numbers in Bulk

  1. Create a new CSV file for the SMS contacts you want to unsubscribe
  2. Make the CSV’s first column Phone Numbers, and fill in the phone numbers you’d like to unsubscribe using one of Klaviyo’s accepted phone number formats
  3. Include the country for each phone number using one of the following options: 
    • Include a second column labeled Country and add in the country name/abbreviation 
    • Include a country code (e.g., 1 for U.S.) at the beginning of every phone number
      A properly formatted spreadsheet ready to be uploaded
  4. In Klaviyo, open the dropdown under your account name 
  5. Click click Account > Settings > SMS
  6. Scroll to the Import SMS Unsubscribes section 
  7. Click Browse Files and upload your CSV file of SMS contacts to unsubscribe 
    In Klaviyo's SMS settings page, a cursor hovers over the Browse Files button
  8. Click Unsubscribe Phone Numbers
  9. Confirm your selection in the modal that appears 

Manually Resubscribing SMS Numbers

SMS profiles that have unsubscribed can resubscribe through a signup form, by texting an opt-in keyword (i.e., START or UNSTOP), or through a Klaviyo user uploading a list of phone numbers and applying SMS consent.

If someone unsubscribed by texting an opt-out keyword to your SMS sending number (e.g., STOP), they must text a resubscribe keyword (i.e., START or UNSTOP) in order to receive messages again. If you attempt to resubscribe one of these profiles through another method, consent will appear in Klaviyo, but mobile carriers will continue to block messages until the recipient texts in a resubscribe keyword.

Additional Resources

Was this article helpful?
235 out of 511 found this helpful