Skip to main content
Resend Docs

Search documentation

Type to search this documentation.

On this pageOverview

Topics

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.

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

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.

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

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 or remove Topics for a given Contact.

Add Contact to 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.

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

Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu