Unsubscribes

By using Customer.io’s unsubscribe functionality, you can offer your customers a way to opt out of your messages. We’ll be able to track the unsubscribe to the specific message they unsubscribed from. For emails, you can also include an unsubscribe option in your email headers.


How unsubscribes work

Unsubscribes in Customer.io are managed using a user profile attribute named unsubscribed that should be assigned a value of true for anyone that is to be treated as unsubscribed. When someone clicks an unsubscribe link that we generate for you, we take care of updating the value of the unsubscribed attribute to true. You can manage this behaviour yourself if you’d like a bit more control.

The behavior of messages sent after a person’s unsubscribed attrbute becomes true is determined by settings on each individual message, as well as the campaign types.

…in segment triggered campaigns and API triggered broadcasts

Messages in these campaigns, by default, do not send to unsubscribed people. This is because these campaign types are generally used for marketing messages that people may want to opt out of.

To override this default, you can click into an individual message and click Edit next to ‘Don’t send to unsubscribed’:

Unsubscribe edit

You’ll then be able to choose from one of the two sending behaviours:

Sending options

We have more information on sending behaviour here.

…event triggered campaigns

To override this default, you can click into an individal message and click Edit next to the unsubscribe behaviour:

Unsubscribe edit

We have more information on sending behaviour here.

…newsletters

Newsletters will not be sent to unsubscribed people; however, there is an option to override this too. When setting up your newsletter, you may have noticed this option:

Option: send newsletters to unsubscribed users

This option will override the Customer.io default, though we ask that you be careful when doing this. Continuing to email someone who has unsubscribed could result in your breaching anti-spam laws in your country, and we do reserve the right to terminate your account if you do so. You can learn more about this behaviour here.

FAQ

What messages will someone stop receiving after unsubscribing?

By default, if a customer is unsubscribed, we will not send them:

  • Newsletters
  • Segment triggered campaign messages (including Push and SMS)
  • API Triggered Broadcast messages (including Push and SMS)

We will send messages from event triggered campaigns, because messaging such as payment invoices or password reminders are sent via event triggered campaigns.

If you’d like to exclude unsubscribes from your event triggered campaigns as well, your best option would be to create a segment where the attribute unsubscribed is not equal to true, like this:

Unsubscribe button

Then, use this as a filter on your campaign. That will ensure that unsubscribed people don’t receive the campaign’s messages.

Unsubscribing a person in the user interface

You can do this on an individual’s Person page, where you can see an ‘Unsubscribe’ button:

Unsubscribe button

Unsubscribing a person via Javascript/our API

Through the API, you’ll need to identify the customer and set the attribute unsubscribed equal true.

<script type="text/javascript">
  // Only send this when a user is logged in
  _cio.identify({
  id: 'user_287',
  unsubscribed: true
});
</script>

This depends on which editor you’re using for your emails.

…in the text and code editor

When using the text and code editor (or creating an associated Layout), you can insert code similar to the following and we’ll render a unique unsubscribe link for that person:

<a href="{% unsubscribe_url %}" class="untracked">Unsubscribe</a>

If you don’t want clicks on the unsubscribe link to be tracked, be sure to include class="untracked"in your unsubscribe link!

…in the drag-and-drop editor

By default, each new email created in our drag-and-drop editor includes an unsubscribe link. If you accidentally delete it, just paste the following text into your email to re-add it:

{% unsubscribe %}

If a user unsubscribes from email, what happens?

For emails, a user clicks the link in the email and arrive at a page that looks like the image below.

Unsubscribe page

If they click, we set the unsubscribed attribute = true and confirm that they are unsubscribed.

Unsubscribe successful

How do I handle more complex messaging preferences?

There are a couple of ways to do this, depending on your specific setup. We have a whole doc dedicated to multiple subscription types!

We don’t programmatically enforce it but we encourage it. If you are sending marketing email, you should adhere to all local laws about customer communication.

No. While we require you to include an unsubscribe whenever necessary and legal, we allow you to use your own unsubscribe functionality if you so choose. If you do, though, we won’t be able to track which email someone unsubscribed from or place an unsubscribe in your email header.

How do I send my customers to an unsubscribe page in another language?

The {% unsubscribe_url %} liquid can include an optional parameter lang= to redirect to the unsubscribe page in another language. For example, to redirect users to a French translation of the unsubscribe landing page use {% unsubscribe_url lang="fr" %}. This parameter accepts valid ISO 639-1 language codes. Currently we have translations for German, Greek, Spanish, French, Japanese, Polish, Portuguese, Romanian, Russian, Thai, Turkish, and Chinese. If an invalid language code is provided we default back to the English unsubscribe page. We are always willing to add additional languages, so please let us know if you can provide a translation!