# Manage email topics

Set up the subscription topics your customers can choose to receive, and retire the ones you no longer need.

Audience: dealer-managers
Availability: available
Canonical source: https://rooftoprv.com/docs/manage-email-topics

An email topic is a subscription category, such as sales and inventory or service offers. Topics define what a customer can choose to receive. Your marketing content and flows are each tied to a topic.

A topic doesn't subscribe anyone. Every send still checks each recipient's permission.

## Before you start

- To open **Email topics**, you need the **View email programs** permission.
- To add, edit, retire, or restore a topic, you need the **Manage email programs** permission.

## Add a topic

> **Warning:** You can't change a topic's **Stable key** or **Purpose** after you add it. Published content and flows use the key. Check both before you select **Add topic**.

1. Go to **Marketing** > **Campaigns** > **Settings**.
2. Under **Subscriptions**, select **Email topics**.
3. Select **Add topic**. If you have no topics yet, the button reads **Add first topic**.
4. Optional: in **Start with a product topic**, choose a starter.
   The starters are **Sales and inventory**, **Service offers**, and **RV storage**. The starter fills in the fields below. Review them before you add the topic.
5. Enter a **Name** of up to 120 characters.
6. Check the **Stable key**.
   It fills in from the name, in lowercase with hyphens, such as `sales-and-inventory`.
7. Choose a **Purpose**. It starts on **Marketing**.
8. Optional: enter a **Description** of up to 500 characters that says what recipients can expect.
9. Select **Add topic**.
   A **Topic created** message appears. The topic shows in the list as **Active**.

The three purposes:

| Purpose | Use it for |
|---|---|
| **Marketing** | Promotional content |
| **Requested alert** | An alert the recipient asked for and still has active |
| **Operational** | Messages needed to deliver a service, not promotions |

## Edit a topic

1. In the topic's row, select **Edit**.
2. Change the **Name** or **Description**.
   **Stable key** and **Purpose** are locked.
3. Select **Save changes**.

## Retire a topic

Retiring hides a topic from new content and from subscription choices. It doesn't delete the topic or the permission records tied to it.

If published email content still uses the topic, retire that content first.

1. In the topic's row, select **Retire**.
2. Read the **Retire topic?** message.
3. Select **Retire topic**.
   A **Topic retired** message appears and the topic leaves the list.

## Restore a retired topic

1. Above the list, select **Show retired**.
   Retired topics appear with a **Retired** status.
2. In the topic's row, select **Restore**.
3. Select **Restore topic**.
   The topic is available for new content and subscription choices again. Existing permission records don't change.

Select **Hide retired** to show only active topics again.

## What happens next

- The **Subscription topics** check on the readiness checklist needs at least one active topic with the **Marketing** purpose. See [Check email sending readiness](https://rooftoprv.com/docs/check-email-sending-readiness).
- To see one customer's choice for each topic, open **Marketing** > **Campaigns** > **Settings** > **Recipient status**. Find the customer and read **Topic choices**.

## Troubleshooting

**"Could not save topic" or "Could not update topic"**
You need the **Manage email programs** permission. The buttons show without it, but the change fails.

**"Retire published email content that uses this topic first"**
Published email content still uses the topic. Retire that content, then try again.

**I added a topic and saw "Topic created," but nothing new is in the list**
A topic with that **Stable key** already exists, so no second topic was made. Select **Show retired** to check whether it was retired, then restore it. To make a separate topic, use a different key.

**"Topic purpose cannot be changed"**
A topic with that **Stable key** already exists with a different **Purpose**. Use a different key.

**"More than 100 topics exist"**
The list shows the first 100 topics. Retire topics you don't use.

**The Scope column says Tenant**
That means the topic belongs to your whole dealership.

## Related guides

- [Check email sending readiness](https://rooftoprv.com/docs/check-email-sending-readiness)
- [Group contacts into segments](https://rooftoprv.com/docs/group-contacts-into-segments)
