Skip to content

Customize your email subscription pages

Last updated: June 24, 2024

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

Marketing Hub   Professional , Enterprise
Content Hub   Professional , Enterprise
Legacy Marketing Hub Basic

You can design and customize your email subscription pages to 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: 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).

Subscription page domain

Subscription preferences pages are hosted on your email sending domain. If no email sending domain is available, preference pages will remain hosted on a HubSpot email domain (e.g.,

Edit subscription page templates

Please note: if you've purchased the Business Units Add-on, you can only use one default subscription preference page for all business units, and further customization is not currently supported..

To edit your subscription page templates:

  • In your HubSpot account, click the settings settings icon in the top navigation bar.
  • In the left sidebar menu, navigate to Marketing > Email.
  • Click the Subscriptions tab.
  • For each subscription page, click the dropdown menu and select a template
  • To edit a subscription page template in the design manager, click Actions > Edit.


  • In the design manager, edit your template:
    • If you're using a default template, click Clone template in the banner. In the dialog box, enter a name for your new template, then click Clone template.
    • 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.
    • You can add modules to your subscription preferences page to allow contacts to request that their personal data be emailed to them or deleted. This function is required under certain data privacy laws. Learn more in our developer docs
  • In the upper right, click Publish changes. The template will now be available to select from the dropdown menu in your email settings.
  • If you want to preview how your subscription page will appear, return to the Subscriptions tab and click Actions > Preview under the associated page.

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 along with a confirmation page that will be shown once someone unsubscribes. Users in a Marketing Hub Professional or Enterprise account can customize the URL of these subscription pages by connecting a domain for the Email content type.

  • Subscription preferences 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.
  • 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 in an email they received.
  • Unknown contact subscription preferences: this page is loaded for visitors who aren't recognized in your contacts database in HubSpot at the time of their visit. These visitors will be shown an error message when visiting the subscription page.


Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.