Detailed guide on how to set up and capture user notification preferences in SuprSend.
channel_preferences
(for channel-level opt-outs), categories
, and opt_out_channels
within each category. In the below example, user has opted out of email
, invoice-ready
category and slack channel in payment-reminder
category.
Don’t add too many categories as it can drive users to use channel level opt-outs.
Creating Billing section
Adding categories in Billing section
opt-out
of does not block notifications from mandatory channels in this category.{{$hosted_preference_url}}
.
This page currently hosts on the SuprSend domain, but you can reach out if you’d prefer it hosted on your own domain.
{{$embedded_preference_url}}
.
Email: Unsubscribe URL header
{{$hosted_preference_url}}
here to load the SuprSend hosted preference page from the email header.Inbox: Render Preference Page within Inbox
Mobile Push: Preference Page in App settings
SMS & Whatsapp: Reply `STOP`
visible_to_subscriber: false
flag in default tenant preferences.
Setting Preference tags
Filter Categories with Tags
tags=tag1
) or a more advanced filter using logical operators.Supported operators:Operator | Operand Datatype | Description | Example |
---|---|---|---|
exists | boolean | Returns categories where any tag is set | tags={"exists":true} |
not | string | Excludes categories that have the specified tag | tags={"not":"admin"} |
or | array | return categories that have any of the mentioned tags | tags={"or":["sales","marketing"]} |
and | array | return categories that have all the mentioned tags | tags={"and":["sales","manager"]} |
tags={"or":[{"and":["sales","manager"]},{"and":["marketing","associate"]}]}
.Evaluating Recipient preferences
Factoring in tenant preferences
Resolving preference conflicts
user > tenant > org
(set in notification category settings). However, if you turn off notifications in a category from the tenant page, users will not receive notifications in that category.Debugging preference evaluation in workflow runs
Subscriber preference update
in request logs.How to setup digest schedule in my preferences?
I have a use case where a company has multiple departments/roles, and the admin will set preferences for users in these departments.
What happens to existing user preference view if I change default preference setting?
I have multiple enterprise customers with various product offerings. Customers should only receive notifications for the products they have enabled, and the same should be visible on their preference page. How can I manage this in SuprSend?
visible to subscriber
to false
in the default tenant preferences to hide the category from the tenant’s end users.