Understanding unsubscribes in Klaviyo

Last updated at:

You will learn

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 %}


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 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
    An account's suppressed profile count in the Lists & Segments tab
  3. Choose whether you want to suppress a single profile or bulk suppress many profiles
    • To suppress a single profile, click the Add Email Address button
    • To bulk suppress contacts, use the Upload File button

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
    The list suppressions option in the Manage List menu
  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
    An email is added to a suppression list manually

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

The suppression list's filter option

Share a global unsubscribe link with someone

  1. Navigate to 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 (paid plans only): 

  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
    The global unsubscribes setting has been disabled for an account

Learn how to remove suppressed profiles from a list.

When someone unsubscribes and re-subscribes

Whenever someone unsubscribes from your emails or is suppressed for deliverability reasons (i.e., an email hard bounced or is invalid), they become globally suppressed and unable to receive marketing emails 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 sign-up form or subscribe page 
  • Filling out a form built using Klaviyo’s subscribe endpoint (either a third-party form, or a form built by your developers)
  • Uploading a CSV file with email consent
  • For Shopify: Subscribing at checkout

If a contact who was suppressed for deliverability reasons (i.e., hard bounces or invalid emails) resubscribes, the deliverability suppressions will remain. 

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 re-added to List A
  • If someone unsubscribes from an event-based flow, then subscribes to List A, they will be added to List A and begin receiving future emails

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 or resubscribe next to their suppression reason
    A cursor hovers over the Remove button for a profile's suppression

Note that if you click resubscribe next to a profile’s suppression reason, you are indicating that you have explicit consent to send email marketing to that recipient. 

SMS unsubscribes

Manually unsubscribe an SMS number 

  1. Navigate to the Profiles tab or search by name or phone number
  2. Click the recipient who you want to remove SMS consent for
    A Klaviyo profile, with SMS consent in the Channels box
  3. On the right-hand side, locate Channels
    The channel consent box, with SMS consent
  4. Under the phone number, click Show consent details to show additional information
    The profile has been manually unsubscribed from SMS
  5. Click Unsubscribe from SMS 
  6. Confirm your choice in the modal that pops up
  7. 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 spreadsheet ready for upload
  4. In Klaviyo, open the dropdown under your account name 
  5. 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
    The SMS Unsubscribes upload tool
  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 (e.g., UNSTOP), or through a Klaviyo user uploading a list of phone numbers and applying SMS consent.

In most cases, when someone opts out, they can resubscribe via a form, texting an opt-in keyword, etc. However, if someone used STOP to opt out, they must text 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?
307 out of 672 found this helpful