Magento 2 Add custom font to Email Template

Magento 2 Add custom font to Email Template

August 20, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento 2 Add custom font to Email Template

Solving Font Issues in Magento 2 Email Templates

Understanding the Problem

You’ve followed the official Magento guide on customizing email templates to include your own font. You’ve added the font files to the correct directory, updated your Less files with the appropriate declarations, and even executed necessary commands for deployment and reindexing. However, when you send an email or preview the template in the backend, the custom font isn’t applied correctly.

The Underlying Issue

The problem likely stems from how Magento 2 handles CSS in emails. Email clients like Gmail and Outlook strip out certain styles to maintain a clean visual presentation. This stripping process often removes custom font definitions that aren’t declared using the font-family property directly on an element, which is what you’ve done in your Less files.

The Solution Approach

To resolve this issue, we need to ensure that our custom font declaration is included in the CSS file used by the email template. We’ll do this by adding a direct reference to the custom font family in the css directory of your theme.

Step-by-Step Resolution

  1. Locate Your Email Template CSS

    Navigate to your theme’s css directory: {luma-theme-path}/css/. You should see files like email.css.

  2. Add Direct Font Declaration

    Open the email.css file and add a direct declaration for your custom font family at the top of the file:

    @font-face {
        font-family: 'my_family_name';
        src: url('@{baseDir}/fonts/my_font_name');
    }
    
  3. Reference the Custom Font

    In the styles section where you want to apply your custom font, add a font-family declaration:

    .your-class {
        font-family: 'my_family_name', sans-serif;
    }
    
  4. Deploy Your Changes

    After making these modifications, run the following commands again:

    php bin/magento setup:static-content:deploy -f
    php bin/magento indexer:reindex
    php bin/magento cache:clean
    

Why This Works

By adding a direct font-face declaration in the email CSS file, we ensure that the custom font definition is included when the CSS is aggregated for the email. This approach bypasses the Less compilation step and places the font definition directly where it needs to be.

Best Practices for Email Fonts

  • Always use @baseDir or skin_url for font paths to ensure they are processed correctly.
  • Test your email templates across multiple clients (Gmail, Outlook, Apple Mail) to ensure cross-browser compatibility.
  • Keep your CSS simple and avoid complex selectors that may not be supported by all email clients.

Conclusion

When working with custom fonts in Magento 2 email templates, it’s crucial to understand the limitations of how email clients handle CSS. By directly including the font definition in the theme’s CSS files used for emails, you can ensure your custom fonts are applied correctly regardless of the client.

Remember that email design is a unique challenge compared to traditional web development. Always test thoroughly and keep an eye on updates from Magento and the email community for best practices.

Magento 2 Indexing Themes Admin

Our network