---
sourceDocument: Brazil ServiceNow AI Platform Administration
sourceDocumentLink: https://www.servicenow.com/docs/r/platform-administration

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil ServiceNow AI Platform Administration

ft:clusterId :

    - platadm

bundleId :

    - platadm

workflow :

    - Platform


---

# Email unsubscribe links

# Email unsubscribe links {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read
Summarize  
![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI  
This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.  

## Summary of Email unsubscribe links

ServiceNow administrators can enable users to unsubscribe from specific email notifications by adding unsubscribe links in email layouts, templates, or notifications.
Base system notifications already include these unsubscribe and notification preference links.
Two unsubscribe link types are available: one that generates a preformatted unsubscribe email message to the instance (unauthenticated), and another that opens the user's notification preferences page on the instance (authenticated).
Show full answer Show less  

## Key Features

* **Unsubscribe by Email (Unauthenticated):** Using the macro `${NOTIFUNSUB}`, an HTML mailto hyperlink is created. When clicked, it opens the user's email client with a prefilled unsubscribe message directed to the instance. This method does not require the user to be logged in.
* **Unsubscribe by Notification Preferences (Authenticated):** The macro `${NOTIFPREFS}` generates a direct link to the user's notification preferences page within the ServiceNow instance, allowing users to customize or disable notifications after logging in.
* **Customizable Link Text:** Both macros support a `linktext` parameter to specify the clickable text shown in the email.
* **List Unsubscribe Header Support:** Administrators can enable list unsubscribe headers that provide an unsubscribe link next to the sender's email address in compatible email clients, which automatically sends an unsubscribe request.
* **Handling Translation-Enabled Emails:** When email translations are enabled, administrators can configure system properties and inbound email actions to ensure unsubscribe requests from translated emails are processed correctly.
* **Secondary Email Addresses:** Starting with the Xanadu release, users can unsubscribe individually from notifications sent to secondary email addresses.

## Practical Application for ServiceNow Customers

By incorporating these unsubscribe macros into email notifications, ServiceNow administrators empower users to easily control their notification preferences, reducing unwanted emails and improving user satisfaction. The unsubscribe-by-email option is helpful for users who may not be logged in, while the notification preferences link supports granular control after authentication. Proper configuration ensures compatibility across various email clients and supports multilingual environments.

Administrators should add the unsubscribe macros to relevant notification records and may configure list unsubscribe headers for enhanced email client integration. For environments with translated emails, enabling specific system properties and inbound actions is necessary. Providing both unsubscribe methods ensures accessibility for all users regardless of their email client or authentication status.  
Administrators can enable your users to stop receiving particular email messages by adding unsubscribe links to notifications.  
Note:  
Base system notifications include unsubscribe and notification preferences links.  
The two types of unsubscribe links are:

* An unsubscribe link that creates an email message to the instance.
* An unsubscribe link that opens the notification preferences for the user on the instance.
{#email-unsubscribe__ul_slj_svv_cx}

The available parameter for both of these unsubscribe links is link_text, used to specify the text to display as a link within quotation marks.  
{#email-unsubscribe__table_e1j_5wv_cx__entry__3}

| Unsubscribe type | Macro used | Description |
|-|-|-|
| Unsubscribe by email (Unauthenticated) | ${NOTIF_UNSUB} | The system generates an HTML mailto hyperlink. When users select the link, their browser or email client creates a preformatted unsubscribe email message to the instance. |
| Unsubscribe by notification preferences (Authenticated) | ${NOTIF_PREFS} | The system generates an instance link directly to the notification preferences for this notification type. |
[Table 1. Available unsubscribe macros]

{#email-unsubscribe__table_e1j_5wv_cx}  
Administrators can add unsubscribe macros to the following notification record types:

* Email layouts
* Email templates
* Email notifications
{#email-unsubscribe__ul_gyr_cfw_cx}

## Unsubscribe by email {#email-unsubscribe__section_vzy_gyf_5bb}

You can enable users to unsubscribe from emails either by using the list unsubscribe header or a preformatted email message.

* Unsubscribe using list unsubscribe header  
  Unsubscribing from email notification using the list unsubscribe header provides users with an unsubscribe link that appears next to the email address. It sends an unsubscribe request and a preformatted email message is automatically sent.  
  Note:  
  The unsubscribe option or the placement of the button can vary based on the email client being used.
* Unsubscribe with preformatted email message  
  Unsubscribing by email requires the user email client or browser to create a preformatted email message containing the following elements:
  * The To field includes the email address of the instance.
  * The Subject starts with the string Unsubscribe from.
  * The Body has a JSON string with a name-value pair consisting of Unsubscribe and an array value that contains two more name-value pairs.
    * The notification_id parameter specifies the sys_id of the notification that the user wants to unsubscribe from.
    * The unsub_token parameter specifies an instance ID that the system uses to verify that the email came from a ServiceNow instance.
    {#email-unsubscribe__ul_ir5_dnh_41c}
  {#email-unsubscribe__ul_hr5_dnh_41c}
{#email-unsubscribe__ul_w2j_nmh_41c}  
Note:  
Some email clients and web browsers, such as Gmail on Chrome, require extra client configuration to support mailto hyperlinks. Administrators can provide an alternative unsubscribe method for users whose email client or browser doesn't support mailto links.

The Unsubscribe from Notification inbound action processes the email and unsubscribes the sender from the listed notification. Unsubscribing by email message doesn't require users to authenticate with the
instance first.  
For translation-enabled emails, if the unsubscribe option does not work, follow these steps:

1. Create a system property named glide.email.translation.unsubscribe.prefix and set it to true. Enabling this property adds the prefix \[UNSUB\] : to the preformatted email subject line.
2. Activate the Unsubscribe from Translated Notifications inbound email action, or update the existing Unsubscribe from Notification inbound email action to include the \[UNSUB\] : prefix in the subject line using conditions or a script.

{#email-unsubscribe__ol_xfr_kzv_23c}  
Note:  
Users with multiple subscribed email addresses who unsubscribe from the primary email address are automatically unsubscribed from all other email addresses. Unsubscribing through secondary email addresses is supported beginning with the Xanadu release. The request is fulfilled only for that secondary email address.

## Unsubscribe by notification preferences {#email-unsubscribe__section_opr_qyf_5bb}

Unsubscribe by notification preferences requires the user's browser to navigate to the notification preferences page on the instance. After logging in, the system displays the notification preferences for this particular
notification.

You can set preferences for this notification such as disabling notifications for a particular device and save the notification preferences for changes to take effect.  

## Unsubscribe links

This email layout adds several unsubscribe links to the bottom of each email notification.

    ${NOTIF_UNSUB} from this notification by email or ${NOTIF_UNSUB+link_text="click
          here"}.
    Manage your ${NOTIF_PREFS} or ${NOTIF_PREFS+link_text="click here"}.

When rendered in an email notification, the unsubscribe links display only the link text.  
Figure 1. Sample email with unsubscribe links

If the Unsubscribe link is selected, the email client creates a message similar to the one shown in the following figure.  
Figure 2. Sample unsubscribe by email message