BugWP logo BugWP
Back to Community
Home / Community / Plugin → Custom fonts – host your fonts locally

Understanding Custom Fonts Plugin Compatibility: A Guide for WordPress Users

12 threads Sep 17, 2025 Plugin → Custom fonts – host your fonts locally

Content

Many WordPress users choose the 'Custom Fonts – Host Your Fonts Locally' plugin to easily manage and serve fonts from their own server. A common point of confusion, however, revolves around which themes and page builders the plugin supports. This guide explains the plugin's compatibility and provides workarounds for unsupported setups.

What is the Core Issue?

The 'Custom Fonts – Host Your Fonts Locally' plugin is not universally compatible with all WordPress themes and page builders. It requires specific integration code to appear as a font selection option within a theme's customizer or a page builder's font controls. Without this integration, the fonts you upload will not appear in dropdown menus, though they are technically loaded on the site.

Officially Supported Themes and Builders

Based on the plugin's support history, it is designed to work seamlessly with a limited set of themes and page builders. The officially supported software includes:

  • Astra Theme
  • Beaver Builder Theme
  • Beaver Builder Plugin
  • Elementor Page Builder

If you are using one of these, the plugin should work without any extra steps, and your fonts will appear in the appropriate typography controls.

Common Unsupported Software and Workarounds

The plugin's support team has confirmed it does not have out-of-the-box compatibility with many popular tools, including:

  • Divi Theme & Builder
  • Kadence Theme
  • Oxygen Builder
  • WPBakery Page Builder
  • Hello Elementor Theme
  • Visual Composer
  • Spectra One Theme (as of the time of writing)
  • Porto Theme
  • MaiTheme

If your theme or builder is not supported, you have two primary options:

1. Use Custom CSS

The most reliable method for unsupported themes is to manually apply your custom font using CSS. Once you have uploaded a font through the plugin, you can target any HTML element on your site.

Example CSS for H1 Headings:

h1 {
    font-family: 'YourCustomFontName', sans-serif;
}

You would replace YourCustomFontName with the exact name you gave the font when uploading it. You can add this CSS in the Customizer > Additional CSS section or in your theme's settings if it provides a custom CSS option.

2. Contact Your Theme Developer

Since compatibility must be added from the theme or builder's side, you can contact their support team and request they add integration for the 'Custom Fonts' plugin. This is a long-term solution that benefits all users of that theme.

Future Compatibility

The 'Custom Fonts – Host Your Fonts Locally' team has indicated they maintain a to-do list for future compatibility. User requests for themes like Divi and Oxygen Builder have been noted for consideration in future updates. However, there is no public timeline for when new integrations might be released.

Conclusion

While the 'Custom Fonts' plugin is an excellent tool for managing local fonts, its functionality is currently limited to a specific set of themes and builders. For unsupported software, using custom CSS is the most effective immediate solution. For native integration, encouraging your theme's developer to add support is the best path forward.

Related Support Threads Support