Information for: DEVELOPERS   PARTNERS

Preference centers

Preference center pages enable your contacts to decide which messages they’d like to receive, rather than unsubscribing from all communication. This includes preferred channels and timing for how and when contacts receive messages.

Building a preference center page

Preference Centers are landing pages, so navigate to Landing Pages in the Components section of Mautic. For general landing page information, see Landing pages.

To make a page a preference center page:

  1. In the general options, Set Is preference center to Yes.

    Preference Center

  2. Before opening the builder, select the theme you’d like to use. You may use a default Mautic theme, but custom themes are easier to align with corporate branding. If you’re creating a custom theme for a preference center, include landing page and form styling.

If you build more than one preference center, with different options or different branding, for different campaigns or emails, name them appropriately so you can find the right page later.

Slot types

Preference Center Slots

Many of the slot types available on preference center pages are also standard landing page slots. Those slots are usable on preference center pages, if you’d like to add more content beyond preference options.

The following slots are specific to the preference center:

  • Segment List: Displays a list of all segments a contact is a member of. If a segment has the Available in Preference Center option set to No, it won’t display.
  • Category List: Displays categories used by emails, enabling contacts to opt in or out of receiving content from those categories.
  • Preferred Channel: Enables contacts to choose which channels they’ll primarily receive messages on, for channels you’ve enabled in your instance. This is primarily useful if you’re using the Marketing Messages feature.
  • Channel Frequency: Enables contacts to set how often they receive messages. This also includes vacation preference settings, enabling contacts to turn off communication from you for a specified time. If a contact clears the check box next to a channel, you can’t contact them through that channel. If you haven’t configured a transport for a channel, the channel won’t display. For example, if you haven’t set up a text messaging service, contacts won’t see SMS listed as a channel.
  • Save Preferences (Required): The other preference center slots make up a form, while the Save Preference slot acts as the submit button for the form. If a preference center page doesn’t contain the Save Preferences button, contacts will see a default, unbranded page. You can style the button like any other button on a landing page.
  • Success Message: After a contact clicks the Save Preferences button, Mautic can display a confirmation message. Drag the slot onto the page, and edit the content like a text slot. Any content here will display after the form submission.

Using a preference center page

Complete the following steps to ensure contacts can see your preference center page.


Set the following options to configure your preference center:

  1. Navigate to Settings > Configuration > Email settings.

  2. Scroll to the Unsubscribe Settings to set your preference center settings. If the Show contact preference settings option is No, contacts who click the Unsubscribe link in an email see a page with the Unsubscribed confirmation message


    Options toggled to No don’t display on preference centers even if the preference center includes a slot for the option.

Email Settings - Unsubscribe Settings
  1. Set the Text for the {unsubscribe_text} token: Change a basic Unsubscribe link to a personalized message. For example, Update your contact preferences or Don't want to hear from us anymore? Click here.

    Edit between the anchor (<a href=|URL|"> </a>) tags. The URL is a token, so don’t change it. To use custom text on an email, hyperlink the text with the {unsubscribe_url} token as the link.

  2. Set Unsubscribed and resubscribed confirmation message: If a contact unsubscribes or resubscribes, the message in this field displays on the page after the respective action.


    Don’t edit the |EMAIL| or |URL| tokens in the <a href> tag.

  3. Set Show contact preference settings: When set to Yes, the unsubscribe link directs the user to the preference center, if one has been created.

    If you haven’t created a preference center, Mautic creates a default page with the next 5 settings based. The default theme which determines the styling.

  4. Set Show contact segment preferences: Toggle the setting to Yes to enable a contact to change which segments they’re part of on the preference center page. Segments display on the preference center page if they’re published and public.

  5. Set Show contact frequency preferences: Toggle the setting to Yes to enable an individual to limit the number of marketing messages they receive on each channel from the preference center.

  6. Set Show pause contact preferences: When set to Yes, a contact can disable messages from your Mautic account to their email address for a specified date range. This isn’t a full unsubscribe. At the end of the date range the messages resume sending to the contact.

  7. Show contact’s categories: If you have categories set for contacts, campaigns, emails, etc., and set this option to Yes, the contact can opt out of the categories they choose from the preference center page.

  8. Show contact’s preferred channel option: If you have multiple channels available in your Mautic account (email, SMS, mobile push, web notifications, etc.), contacts may choose their preferred channel. This can be useful when using the Marketing Messages feature of Mautic.

Email editor

After creating a preference center, you must attach it to an email.

In the email editor, in the general options section, use the Preference center page menu to choose your preference center. Only landing pages which are configured as preference centers display in the menu. If a preference center isn’t selected, when a contact clicks unsubscribe they won’t see your branded page. Instead, they’ll see either default preference page or the unsubscribe confirmation.

Email - Preference Center Selector

After you’ve sent an email, you may change the preference center. When contact click the unsubscribe link from the email, they’ll see the update page. They won’t see the page as it displayed when you sent the email they clicked on.

Adding other forms

Mautic’s preference center pages support more forms, beyond the actual preference form constructed with various slots. To add another form, which may enable a contact to update the information you have on their profile, use the token {form=ID#}. You can build a form specifically for the landing page, with the fields you’d like to enable contacts to update on their own.