Skip to main content
Topics are currently in private beta and only available to a limited number of users. APIs might change before GA.To use the methods on this page, you must upgrade your Resend SDK:
npm install resend@6.3.0-canary.1
Get in touch if you’re interested in testing this feature.
Managing subscribers and unsubscribers is a critical part of any email implementation. Topics are used by your contacts to manage their email preferences. When you send Broadcasts, you can optionally scope sending to a particular Topic. Not only does scoping your sending help you send more precisely, but it also allows your users to manage their preferences with more control.
Learn more about customizing your team’s unsubscribe page

​
Add a Topic

You can create a new Topic from the dashboard or via the API.
  1. Click Create Topic.
  2. Give your Topic a name.
  3. Give your Topic a description (optional).
  4. Select Opt-in or Opt-out as the default subscription. This value cannot be changed later.
    • Opt-in: all Contacts will receive the email unless they have explicitly unsubscribed from that Topic.
    • Opt-out: subscribers will not receive the email unless they have explicitly subscribed to that Topic.
Add Topic

​
View all Topics

The dashboard shows you all the Topics you have created along with their details. View All Topics You can also retrieve a single Topic or list all your Topics via the API.

​
Edit Topic details

After creating a Topic, you can edit the following details:
  • Name
  • Description
To edit a Topic, click the More options button and then Edit Topic. View edit topic You can also update a Topic via the API.
You cannot edit the default subscription value after it has been created.

​
Delete a Topic

You can delete a Topic by clicking the More options button and then Remove Topic. Delete Topic You can also delete a Topic via the API.

​
Editing Topics for a Contact

As you receive proper consent to email Contacts, add the Contact to a given Topic. A Contact can belong to multiple Topics. You can add a Contact to a Topic via the dashboard by expanding the More options and then Edit Contact. Add Contact to Topic Add or remove Topics for a given Contact. Add Contact to Topic
The Subscribed status is a global setting that enables or disables sending to a Contact for Broadcasts.
  • If a Contact’s Subscribed status is false, they will not receive emails from your account, even if they have opted-in to a specific Topic.
  • If the Subscribed status is true, they can receive emails from your account.

​
Sending Broadcast with a Topic

You can send with a Topic in the Broadcast editor from the Topics dropdown menu. Send emails with a Topic You can also send with a Topic via the Broadcast API.

​
Unsubscribing from a Topic

If a Contact clicks a Broadcast unsubscribe link, they will see a preference page where they can:
  • Unsubscribe from certain Topics (types of email)
  • Or unsubscribe from everything you send
If they unsubscribe from a Topic or several Topics, they will no longer receive emails for those Topics. If they unsubscribe from all emails from your account, Broadcasts will no longer send to them. You can customize your unsubscribe page with your branding from your team settings. See Topics on the Unsubscribe Page
⌘I