Skip to content

Customize your email subscription pages

Last updated: August 18, 2023

Available with any of the following subscriptions, except where noted:

Marketing Hub Professional, Enterprise
CMS Hub Professional, Enterprise
Legacy Marketing Hub Basic

Email subscription pages provide a way for your contacts to manage their subscription preferences, unsubscribe from your emails, or confirm a specific subscription. These subscription pages are created as system templates, rather than individual pages. The way they render depends upon the recipient's email preferences.


Please note:

  • If you purchased the Business Units add-on, you cannot currently customize the appearance of your subscription pages.
  • Because the subscription statuses that appear on your subscription pages depend on the contact who navigates to them, you cannot include a public link to a subscription page on your website. Instead, contacts must navigate to one of your subscription pages via a link in one of your sent emails (e.g., a URL in the footer of one of your marketing emails).

To edit your subscription page templates:

  • In your HubSpot account, click the settings settings icon in the main navigation bar.
  • In the left sidebar menu, navigate to Marketing > Email.
  • Click the Subscriptions tab.
  • Use the dropdown menus to select a template to use for each of your subscription pages. To edit a subscription page template in the design manager, click Edit Page.

  • The template will open in the design manager in a new browser tab.
  • Edit your template:
    • If you're using a default template, click Clone template in the banner. Then, in the dialog box, enter a name for your new template, then click Clone.
    • If you're using a coded template, you'll need to edit the email_subscriptions HubL token. Learn more about the available parameters in the HubSpot CMS Docs.
  • In the upper right, click Publish changes. The template will now be available to select from the dropdown menu in your email settings.

Please note: if you notice that null is being added to the URL of any of your subscription pages after you've published them, try removing any third-party JavaScript files or libraries that you've added to your site.

Types of email subscription pages

Your email subscription pages allow your contacts to update their subscription preferences. You can also customize a backup unsubscribe page for unrecognized visitors who still want to unsubscribe from your emails, along with a confirmation page that will be shown once someone unsubscribes. If you have a Marketing Hub Professional or Enterprise account, you can customize the URL of these subscription pages by connecting a domain for the Email content type.

  • Subscription preference page: this page features a name and description of each subscription type defined in your email settings. Users can choose which type of email communications they want to receive from your organization or unsubscribe from all communications on this page. This page is displayed after a user clicks the Manage preferences link from an email they received.
  • Unsubscribe backup page: this page is loaded for visitors who aren't recognized in your contacts database in HubSpot at the time of their visit, and allows visitors to manually enter their information to unsubscribe from future email communications.
  • Subscription update confirmation page: this page confirms that HubSpot has received a request to update communication preferences for a visitor. This page is displayed after a user saves their preferences on the subscription preference page, or after the user clicks the Unsubscribe from all emails link from an email they received.
Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.