> ## Documentation Index
> Fetch the complete documentation index at: https://help.getvero.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Setting up your preference center

> Enable the preference center, create your subscription topics, and add preference links to your emails.

Getting the preference center running takes three things: the feature enabled on your project, at least one topic, and a link in your emails that points customers at the page.

## Prerequisites

1. **The preference center enabled on your project** – [contact us](mailto:support@getvero.com) and we will turn it on. It is off by default and cannot be enabled from Settings.
2. **Access to the Vero MCP server** – topics are created through the MCP server rather than the Vero interface. See [Use Vero with AI](/vero-ai/overview) for setup, and [Authentication](/vero-ai/mcp-authentication) for generating an API secret key.
3. **A plan for your topics** – decide what your topics are before creating any, because topics cannot be deleted once they exist.

## Step 1: Plan your topics

A topic should map to a kind of message a customer would reasonably want to keep or drop on its own, such as `Weekly digest`, `Product updates`, or `Offers and promotions`.

Some guidance:

* **Keep the list short.** A page with five topics is easier for your recipients to manage. A page with twenty is more likely to result in an **Unsubscribe from all**.
* **Leave transactional messages untopiced.** Receipts, password resets, and shipping notifications should have no topic, so they are always delivered.
* **Write descriptions from the customer's point of view.** The description appears under the topic name on the preference center. Descriptions are limited to 200 characters.
* **Choose each default status deliberately.** A topic that defaults to `subscribed` includes every customer who has never made a choice. A topic that defaults to `unsubscribed` reaches nobody until a customer has been explicitly opted in [through the API](TODO), or has ticked it and saved their preferences. This suits a topic customers must consent to.

## Step 2: Create your topics

Connect your AI assistant to the Vero MCP server, then ask it to create each topic. The server exposes four topic tools:

| Tool           | What it does                                                                           |
| -------------- | -------------------------------------------------------------------------------------- |
| `topic_list`   | Lists your project's topics with their ids, names, descriptions, and default statuses. |
| `topic_get`    | Reads one topic.                                                                       |
| `topic_create` | Creates a topic.                                                                       |
| `topic_update` | Updates a topic's name, description, or default status.                                |

Asking your assistant in plain language is enough, for example:

```text theme={null}
Create a topic called "Weekly digest", described as
"A round-up of the week's new arrivals, sent every Friday",
that new customers are subscribed to by default.
```

The rules the server enforces:

* `name` is required and must be unique within the project, ignoring case.
* `description` is optional and at most 200 characters. Pass `null` in `topic_update` to clear it.
* `default_status` is `subscribed` or `unsubscribed`, and defaults to `subscribed`.
* Creating and editing topics requires an admin or read-write user. Read-only users can view topics but not change them.

<Note>
  Topics cannot currently be deleted, in Vero or through the MCP server. If a topic is no longer in use, rename it or set its default status to `unsubscribed` and stop assigning it to campaigns. Let us know if deleting topics would be useful to you — we're prioritising what to build next based on what customers ask for.
</Note>

## Step 3: Add preference links to your emails

Four Liquid merge tags become available once the preference center is enabled. Insert them from the data selector in the email editor, or type them directly into your content.

| Tag                               | What it inserts                                                             |
| --------------------------------- | --------------------------------------------------------------------------- |
| `{{url.manage_preferences_link}}` | A URL to the preference center, where the customer can choose their topics. |
| `{{url.manage_preferences}}`      | An anchor tag reading *Manage preferences*, pointing at the URL above.      |
| `{{url.unsubscribe_topic_link}}`  | A URL to the unsubscribe page for the topic this campaign was sent under.   |
| `{{url.unsubscribe_topic}}`       | An anchor tag reading *Unsubscribe*, pointing at the URL above.             |

A typical footer offers both, so a customer can leave one topic in a single step or open the full list:

```html theme={null}
<p>
  <a href="{{url.unsubscribe_topic_link}}">Unsubscribe from these emails</a> or
  <a href="{{url.manage_preferences_link}}">manage your preferences</a>.
</p>
```

<Note>
  `{{url.unsubscribe_topic_link}}` only names a topic when the campaign has one. In a campaign with **No topic**, the link takes the customer to the preference center instead, so it is always safe to include.
</Note>

Both tags are personalised per recipient and carry a signed link, so they cannot be copied between customers.

### Keeping the global unsubscribe link

`{{url.unsubscribe_link}}` and `{{url.unsubscribe}}` continue to work and still unsubscribe a customer from your project entirely.

## Step 4: Preview the pages

While signed in to Vero, you can view the pages with your own topics in place:

* The preference center: [app.getvero.com/unsubscribe/manage/preview](https://app.getvero.com/unsubscribe/manage/preview)
* The topic unsubscribe page: `https://app.getvero.com/unsubscribe/topic/preview/TOPIC_ID`, replacing `TOPIC_ID` with the id returned by `topic_list`

<img src="https://mintcdn.com/vero-c561507b/lkzLhg75fkbkjo6l/images/vero-1/preference-page.png?fit=max&auto=format&n=lkzLhg75fkbkjo6l&q=85&s=b4c155ce47a7a0136df6e707029764ff" alt="The preference center showing a checkbox for each topic, a Save preferences button, and an Unsubscribe from all link" width="1984" height="1754" data-path="images/vero-1/preference-page.png" />

## Limitations

* Topics cannot be created, edited, or viewed in the Vero interface. Only via the MCP or API.
* Topics appear on the preference center in alphabetical order.
* The custom unsubscribe page under **Settings** → **Unsubscribe** is ignored once the preference center is enabled. Vero hosts the whole journey instead.

## Troubleshooting

### The new Liquid tags are missing from the editor

**Possible causes:** The preference center has not been enabled on this project.

**Solution:** [Contact us](mailto:support@getvero.com) to have it enabled. The tags only appear once the project is switched on.

### A preference link takes the customer to the standard unsubscribe page

**Possible causes:** The link was generated before the preference center was enabled on the project, or it was sent from a different project.

**Solution:** Links are checked against the project each time they are opened. Send a fresh test email from the enabled project and follow the link from there.

### The preference center says there are no topics to choose from

**Possible causes:** The project has no topics yet.

**Solution:** Create at least one topic with `topic_create`, then reload the page.

## Next steps

* [Sending a campaign to a topic](/vero-1/preferences/sending-a-campaign-to-a-topic)
* [Subscription topics and the preference center](/vero-1/preferences/subscription-topics-overview)
* [Use Vero with AI](/vero-ai/overview)

## Need Help?

If you have any questions, reach out to us at [support@getvero.com](mailto:support@getvero.com).