How to use unsubscribe detection

Estimated 4 minute read
|
Updated Apr 16, 2025, 6:57 PM EST

You must be an Owner, Admin, or Manager to use this functionality. This feature is also only available for subscribers in the United States. 

Discover how to use the Unsubscribe detection feature, which automatically unsubscribes someone if their message likely contains an opt-out request.  

Using this feature is highly recommended, as the FCC ruled that brands must respect opt-out requests made through “any reasonable means.” 

This information is intended solely for educational and informational purposes and should not be construed as legal advice. The content provided is general in nature and may not reflect the most up-to-date information. Klaviyo strongly advises consulting with a qualified legal counsel to ensure your compliance with applicable laws and regulations in connection with your use of our services.

How it works

How it works

This feature:

  • On by default in Klaviyo 
  • Only affects subscribers in the United States

Unsubscribe detection evaluates all inbound text messages (i.e., ones from your customer to your brand’s sending number). It also assigns an Intent score, which represents the likelihood that the inbound message contains an opt-out request. 

Say that someone texted "SOTP" instead of "STOP" or texted something like "Please no more messages." Clearly, the person intended to unsubscribe, but the keyword is either mis-spelled or missing. In these cases, the Unsubscribe detection feature would still remove consent. 

Contains logic vs. unsubscribe detection

2 key differences between this setting and using contains for a keyword are:

  • With contains, Klaviyo only searches for a word within a message. 
  • With Unsubscribe description, Klaviyo searches for the intent. 

A good example of this is if someone texts “please cancel my order.” In this case, the subscriber will be opted out if CANCEL is set to contains, but they won’t be opted out if using exact match and unsubscribe detection.   

View or change this setting

View or change this setting

To find the Unsubscribe detection feature

  1. Select your account name in the lower left corner.
  2. Click Settings > SMS
  3. Navigate into the Keyword responses tab. 
  4. Scroll to the Unsubscribe detection feature. 
    • This feature is on by default and is recommended if you have SMS subscribers in the United States.
      Unsubscribe detection feature on the keyword responses page
  5. If you want to turn this feature on or off, simply select On or Off, then click Save.  
Review messages that caused an opt-out

Review messages that caused an opt-out

You can and should also review any message that resulted in an unsubscribe based on intent. 

While Klaviyo is offering this feature to assist customers in tracking opt-out requests, tracking opt-out requests made by means other than the FCC’s mandatory opt-out keywords is still your brand’s responsibility. 

You can review inbound messages (including those marked as unsubscribe requests) to confirm that:

  • Those messages have been properly categorized.
  • Other inbound messages (ones not flagged as unsubscribe requests) do not express the intent to opt out. 

The simplest approach is to create a segment and then review the message for each profile. 

Create a segment for unsubscribes based on intent

Create a segment for unsubscribes based on intent

  1. Navigate to Audience > Lists & segments
  2. Select Create New > Create segment
  3. Name the segment (e.g., Intent unsubscribes). 
  4. Set the following condition:
    • What person has or has not done > Sent SMS > at least once in the last > 30 days > where Intent 1 > equals > Ask to unsubscribe
      Example of a segment for everyone unsubscribed based on intent
  5. Click Create segment
Review message that caused the unsubscribe

Review message that caused the unsubscribe

To see which message caused the opt-out: 

  1. Click 1 of the profiles in the segment. 
  2. On the right-hand side, filter the event to Sent SMS.
    Filtering metrics to only show Sent SMS
  3. Click the down arrow next to that metric.
    Arrow to see more details about an event
  4. Review what the person sent by looking at the Message body
    • Intent 1 indicates that there may have been a request to unsubscribe; however, it does not mean an unsubscribe occurred. 
    • The Intent 1 Confidence indicates how confident Klaviyo is that the profile requested to unsubscribe. If this number is low, it may not result in an opt-out.
Additional resources 

Additional resources 

Was this article helpful?
Use this form only for article feedback. Learn how to contact support.

Explore more from Klaviyo

Community
Connect with peers, partners, and Klaviyo experts to find inspiration, share insights, and get answers to all of your questions.
Live training
Join a live session with Klaviyo experts to learn about best practices, how to set up key features, and more.
Support

Access support through your account.

Email support (free trial and paid accounts) Available 24/7

Chat/virtual assistance
Availability varies by location and plan type