Unsubscribe link customization

Starting from 31st January 2024, all email notifications will include an 'Unsubscribe' link. This requirement ensures that your emails are delivered reliably, as it is included in Google's requirements for large email senders.

After a user unsubscribes, all future email notifications will be blocked by our mail provider, rather than being sent to them. The unsubscribe link takes the user to a page where they are given the option to resubscribe, in case they clicked the link by mistake.

We also include email headers which tell mail clients how to automatically unsubscribe. This means that the user can unsubscribe by clicking a dedicated 'Unsubscribe' button in their mail client, rather than clicking the link directly.

By default, the unsubscribe link will appear at the bottom of each email notification, with the text "Unsubscribe from all chat emails". Depending on how your email notifications are configured, different levels of customization are available:

  • If you are using a custom email theme, then you can use the new <UnsubscribeLink> component to customize the link text, styling, and placement.
  • Otherwise, you can change the link text as part of the notification settings.

For custom email themes

Custom themes for email notifications are only available on the Growth plan and up.

If you are using Custom theme email notifications, you can configure the unsubscribe link via the themes dashboard. Open the relevant email theme and add the new <UnsubscribeLink> component.

This component accepts a class property, allowing you to style it using CSS. The component's children are rendered as the link text. For example:

1<UnsubscribeLink class="unsubscribe">
2 Unsubscribe from Example Company chats

Adding the <UnsubscribeLink> component to your live email theme will take effect immediately. If your theme does not contain an <UnsubscribeLink>, we will automatically add an unsubscribe link to the end of the email. This default link will be visible in the theme preview, but will only get sent in real email notifications from 31st January onward.

For basic and legacy email notifications

If you are using Basic or Legacy template email notifications, then you can configure the link text for each role on the notification settings page. The unsubscribe link will be visible immediately inside the preview, but will only get sent in real emails from 31st January onward.

The link will always appear as a standard HTML link at the end of the email notification.


If you have any questions or concerns about the unsubscribe link changes, please get in touch via our live support chat, in the bottom-right corner of your screen. This chat is staffed by our development team and we're happy to answer any of your questions.