Skip to content

Optimize your marketing email for mobile devices (BETA)

Last updated: September 18, 2024

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

All products and plans



If you're drafting a marketing email, you can hide specific sections for recipients on desktop or mobile email clients, as well as change the column configuration and overall layout to tailor to users reading your email on smaller devices. Tailoring your email to different devices can help boost engagement and enhance the overall user experience of your emails.

Please note: this feature is only available when using the drag and drop email editor. Custom coded email templates will still require a developer to create media queries to account for differences in email client size and device type.

Email client support

Most major email providers support the mobile optimization settings that HubSpot provides in the marketing email editor, but the following email clients do not currently support mobile optimized emails:

  • Yahoo! Mail on Android
  • AOL Mail on Android
  • Gmail IMAP (i.e., using the Gmail app with a non-Google account)
  • Some versions of Samsung Mail, such as using an Outlook account connected to Samsung Mail.

If using one of the clients listed above, HubSpot's mobile optimization features that insert media queries that are specific to desktop or mobile will not be applied. Sections set to be hidden for desktop or mobile will also be visible.

Hide modules and sections on desktop or mobile

To customize which modules or sections appear for desktop or mobile recipients:

  • In your HubSpot account, navigate to Marketing > Marketing Email.
  • Click the name of a drafted email, or click Create email in the top right to create a new email.
  • Click the desktop desktop icon or mobile mobile icon at the top of the email editor to configure the settings for each client type.

toggle-between-client-types-in-email-editor

  • Hover over a module or section and click the hide hide icon to hide that module in the version of the email you're editing.
    • To show all hidden modules for a version you're editing, click Show all hidden at the top of the email editor.
    • You can click the view view icon to toggle a hidden module back to visible for that version of the email.

hide-email-module-on-desktop-1

  • In the left pane, you can select the Show as maximum width on mobile devices checkbox to ensure the module or section appears as full width for mobile recipients.

Customize email layout for mobile or desktop

To configure different layout settings between mobile and desktop clients:

  • In the left pane, click the Content tab.
  • To customize how an email section will appear between desktop and mobile:
    • Click one of the email sections.
    • Under the Visibility section, you can toggle the All devices switch off, then click Show or Hide under the respective Desktop and Mobile sections.

configure-section-visibility-for-desktop-and-mobile-email-clients-0

    • In the Layout section, toggle the All devices switch off, then configure the column layout for Desktop and the stacking layout for mobile.

configure-column-and-stacking-for-email-clients

    • You can then edit the section styling for either mobile or desktop clients. Edit the Body colorBorder width and typeBackground type, and Background color associated with mobile or desktop recipients.
  • To customize how a template appears for desktop or mobile recipients:
    • In the left pane, click Design.
    • In the Template section, toggle the All devices switch off.
    • You can then edit the template styling for either mobile or desktop clients. Edit the Body color, Border width and type, Background type, and Background color associated with mobile or desktop recipients.

customize-desktop-and-mobile-appearance-for-template

When you're done editing the visibility and layout settings for your email, you can preview how the email will appear in a number of common email clients.

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