Skip to content

Customize your email subscription pages

Last updated: October 13, 2020

Applies to:

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

Email subscription pages are created as system templates, rather than individual pages. The way they render depends upon the recipient's email preferences.

To edit your subscription page templates:
  • In your HubSpot account, click the settings icon settings 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.

Please note: this template is used for both the {{unsubscribe_link}} and {{unsubscribe_link_all}} tokens at the bottom of your emails, but only clicks on the {{unsubscribe_link_all}} link will show the checkbox to unsubscribe from all email subscription types with one click.

  • 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.