Topics
Learn how to create, view, delete, and manage Topics.
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
Section titled “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:
Go to the **Topics** Dashboard view and click **Create Topic**.
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."
Optionally give your Topic a description.
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.
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.
View all Topics
Section titled “View all Topics”The Topics tab of the Audience Dashboard page shows you all the Topics you have created along with their details.
You can also retrieve a single Topic or list all your Topics via the API or CLI.
Edit Topic details
Section titled “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.
You can also update a Topic via the API.
Delete a Topic
Section titled “Delete a Topic”You can delete a Topic by clicking the More options button and then Remove Topic.
You can also delete a Topic via the API.
Send a Broadcast with a Topic
Section titled “Send a Broadcast with a Topic”You can send with a Topic in the Broadcast editor from the Topics dropdown menu.
You can also send with a Topic via the Broadcast API.
Topic Subscription Statuses
Section titled “Topic Subscription Statuses”When you view a Contact's details, you can see the list of Topics that they are subscribed to.
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
Section titled “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.
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
Section titled “Bulk Subscribe to Topics”You can subscribe multiple Contacts to Topics in the Dashboard at once:
Go to the **Contacts** Dashboard view.
Select multiple Contacts by clicking the checkbox next to each Contact.
Click the **Edit** button in the bulk actions bar.
Select **Subscribe to Topics**
Choose the Topics you want to subscribe the Contacts to.
Click **Subscribe**
Learn more about bulk actions for Contacts.
API Reference
Section titled “API Reference”For complete API documentation, see the Topics API reference.