Manage a profile's topic subscriptions

View a profile’s subscription status for each topic, and subscribe or unsubscribe them from a topic on their behalf.

Each profile has a subscribed or unsubscribed status for every subscription topic in your project. You can see those statuses on the profile and change them when a user asks you to.

​

Prerequisites

1. At least one topic – see Using topics.
2. The Member or Owner role – to change a topic status. Other roles can view statuses but not change them. See Set up team access.

​

Viewing topic subscriptions

The Subscriptions panel on a profile’s Overview tab shows how many topics the profile is subscribed to and lists the first 10 topics. Click View all subscriptions to open the Subscriptions tab, which lists every topic with its Status and when it was Last updated.

Each status shows whether the profile is subscribed and how that status was reached:

• Subscribed (Default) or Unsubscribed (Default) – no choice has been recorded, so the profile follows the topic’s default status.
• Subscribed (Opted In) or Unsubscribed (Opted Out) – an explicit choice was recorded, from the preference center, the API, or this page.

​

Changing a topic subscription

1. Open the profile and select the Subscriptions tab.
2. Click the actions menu (…) on the topic’s row.
3. Select Subscribe… or Unsubscribe….
4. Confirm by clicking Subscribe or Unsubscribe.

The change takes effect immediately and is recorded as Opted In or Opted Out.

Only change a topic subscription when you have the user’s explicit consent, such as a request to your support team.

​

Changing topic subscriptions through the API

To set topic statuses from your own systems, such as your signup form or another tool that holds consent, include preferences.topics when you identify a user. Each item names one topic by either its id or its name, and sets its status to subscribed or unsubscribed.

{
  "id": "1000",
  "email": "[e-mail]",
  "preferences": {
    "topics": [
      { "name": "Weekly digest", "status": "subscribed" },
      { "id": 12, "status": "unsubscribed" }
    ]
  }
}

Topics you leave out keep their current status. Statuses set through the API are recorded as Opted In or Opted Out, the same as changes made on the profile.

​

Topic and global subscription status

Changing a topic status does not change the profile’s global subscription status. A profile that is globally unsubscribed receives no messages, whatever its topic statuses. To change the global status, use the Actions menu on the profile. See Unsubscribe a user.

​

Next steps

• Subscriptions overview
• Manually edit user profile data

​

Need Help?

If you have any questions, reach out to us at [e-mail].