Skip to main content
Managing subscribers and unsubscribers is a critical part of any email implementation. Topics let your Contacts self-manage their marketing email preferences. Instead of having a single unsubscribe option for all emails, Topics let your Contacts opt in or out of specific types of communications. This keeps them subscribed to the emails they want to receive. When you send Broadcasts, you can optionally scope sending with a particular Topic. Not only do Topics help you send more precisely, but they also give your users more control over which emails they receive.

​
Create a Topic

You can create a new Topic in the Dashboard or programmatically from the Topics API, with a Topics CLI command, or with MCP. To create a Topic in the Dashboard:
1

Go to the Topics Dashboard view and click Create Topic.

2

Enter a name for your Topic.

Choose something that will help your recipients decide whether they are interested in receiving these emails, like “announcements” or “product reviews.”
3

Optionally give your Topic a description.

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.
5

Select Public or Private as the visibility.

  • Private: Only Contacts who are opted in to the Topic can see it on the unsubscribe page.
  • Public: All Contacts can see the Topic on the unsubscribe page.
Add Topic

​
View all Topics

The Topics tab of the Audience Dashboard page 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 or CLI.

​
Edit Topic details

After creating a Topic, you can edit the following details:
  • Name
  • Description
  • Visibility
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.

​
Send a 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.

​
Topic Subscription Statuses

When you view a Contact’s details, you can see the list of Topics that they are subscribed to. Topic Subscription Statuses You can also check a Contact’s subscribed Topics via the API or SDKs or with a Contacts CLI command.

​
Updating a Topic Subscription for a Contact

When you create new Topics, you can update the subscription preferences of your Contacts to include these Topics. A Contact can belong to multiple Topics, and Resend automatically provides an unsubscribe flow for users who decide to opt out of receiving these emails. You can add a Contact to a Topic via the Dashboard by expanding the More options and then Edit Contact. Add or remove Topics for a given Contact. Add Contact to Topic You can also update a Topic subscription for a Contact via the API or SDKs or with a Contacts CLI command.

​
Bulk Subscribe to Topics

You can subscribe multiple Contacts to Topics in the Dashboard at once:
1

Go to the Contacts Dashboard view.

2

Select multiple Contacts by clicking the checkbox next to each Contact.

3

Click the Edit button in the bulk actions bar.

4

Select Subscribe to Topics

5

Choose the Topics you want to subscribe the Contacts to.

6

Click Subscribe

Learn more about bulk actions for Contacts.

​
API Reference

For complete API documentation, see the Topics API reference.