Blogging & content · Guide
How to Add Fonts to WordPress (Step by Step)

Short answer
To add fonts in a WordPress block theme, go to Appearance > Editor > Styles > Typography, open the font manager, and upload font files or install Google Fonts. Classic themes need the theme's Customizer options or a fonts plugin. Developers can also load fonts with CSS @font-face in a child theme or register them in theme.json.
Key takeaways
- Block themes use the Font Library, added in WordPress 6.5, to upload and install fonts.
- Classic themes rely on Customizer options or a fonts plugin.
- CSS @font-face in a child theme works with any theme.
- Use WOFF2 files, few weights and local hosting for speed and privacy.
- Adding a font is not enough: you must also apply it to text.
How do you add fonts to WordPress?
Block themes add fonts through the Font Library, classic themes use a fonts plugin or theme option, and any theme can load fonts with CSS @font-face in a child theme.
Once a font is added, you still need to apply it to your text. Adding and applying are two separate steps, which is where many people get stuck.
This guide focuses on getting new fonts into WordPress. For choosing and switching fonts across headings and body text, see our companion guide on how to change the font in WordPress.
What do you need before adding a font?
Before adding a font, you need the font files or the font's name on a service like Google Fonts, a license that allows web use, and to know whether your theme is a block theme or a classic theme.
Check three things:
- The license. Free fonts from Google Fonts can be used on websites. Paid fonts need a web or webfont license. Desktop-only licenses often do not cover websites.
- The file format. WOFF2 is the best choice for the web because it is compressed. TTF, OTF and WOFF also work.
- Your theme type. Look in Appearance. If you see Editor, you have a block theme. If you see Customize and Widgets, it is a classic theme.
Try to limit yourself to two font families and only the weights you need. Every extra file adds weight to your pages.
How do you upload a font with the Font Library?
In a block theme, go to Appearance > Editor > Styles > Typography, open the font manager, choose the Upload tab, drop in your font files, and they become available in every typography setting on the site.
The Font Library arrived in WordPress 6.5. The Font Library documentation on WordPress.org describes each screen.
Step by step:
- Go to Appearance > Editor.
- Click Styles, then Typography.
- Click the manage fonts option next to the Fonts list.
- Open the Upload tab.
- Drag in your font files, or click to choose them from your computer.
- Close the panel. Your font now appears in the font list.
Upload each weight and style you want, such as Regular, Italic and Bold. If you upload only Regular, the browser may fake bold text, which looks worse.
WordPress stores uploaded fonts in a fonts folder inside your uploads directory, as explained in the Font Library storage update on Make WordPress Core.
How do you install Google Fonts from the Font Library?
Open the font manager in Styles > Typography, choose the Install Fonts tab, allow WordPress to connect to Google Fonts, pick a family and its variants, and click Install to download the files to your own site.
The first time, WordPress asks for permission to connect to Google Fonts. This is a one-time step.
After you install a font, the files are saved on your own server. Visitors then load the font from your site, not from Google. That is better for privacy and often faster.
Pick only the weights you will use. Installing every variant of a big family adds files you do not need.
How do you add fonts in a classic theme?
Classic themes do not use the Font Library, so you either pick fonts from your theme's Customizer options, if it offers them, or install a fonts plugin that adds upload and Google Fonts support.
Many popular classic themes have a Typography section under Appearance > Customize. Some include a full Google Fonts list. Others let you upload custom fonts in a premium version.
If your theme has no font options, a fonts plugin fills the gap. Search the plugin directory for terms like custom fonts or Google Fonts. Read reviews and check when each plugin was last updated before you install it.
Most plugins add a new menu where you upload the font file or choose a Google Font. They then add the font to the Customizer or let you assign it to elements with simple settings.
How do you add a font with CSS @font-face?
Upload the font files to your child theme, write an @font-face rule that points to them, enqueue the stylesheet, and then use the font-family name in your CSS rules.
This method needs no plugin and gives you full control. Add the font files to a fonts folder in your child theme, then add CSS like this:
@font-face {
font-family: "Brand Sans";
src: url("fonts/brand-sans.woff2") format("woff2");
font-weight: 400;
font-style: normal;
font-display: swap;
}
body { font-family: "Brand Sans", Arial, sans-serif; }
The MDN reference for @font-face explains each property. The font-display: swap line shows a fallback font while the custom one loads, so text never stays invisible.
Add a separate @font-face block for each weight and style you use.
How do you register fonts in theme.json?
Theme developers can register fonts in a block theme's theme.json file under settings.typography.fontFamilies, including fontFace entries that point to font files bundled with the theme.
Fonts registered this way appear in the editor's typography controls for every user. They are also loaded only when needed.
The theme.json typography reference shows the exact structure. Our guide on how to use theme.json covers the file in general.
This is the best option if you build or maintain a custom block theme. For one-off sites, the Font Library is usually easier.
How do you add custom fonts in Elementor?
Elementor Pro has a Custom Fonts feature where you upload font files and give the font a name, and it then shows up in every Elementor typography dropdown; the free version can use Google Fonts and your theme's fonts.
The menu usually sits under Elementor > Custom Fonts in the dashboard, though the exact location can change between versions. Upload each weight, save, and select the font in Elementor's Site Settings under Typography.
Setting fonts in Elementor's global Site Settings is better than styling each widget one by one. You change it once and the whole site updates.
Which method should you use?
The right method depends on your theme, your editor and how comfortable you are with code.
| Method | Works with | Skill level | Hosting of font files |
|---|---|---|---|
| Font Library upload | Block themes (WordPress 6.5+) | Beginner | Your server |
| Font Library Google Fonts | Block themes (WordPress 6.5+) | Beginner | Your server after install |
| Theme Customizer | Many classic themes | Beginner | Depends on theme |
| Fonts plugin | Classic themes, any editor | Beginner | Depends on plugin setting |
| CSS @font-face | Any theme with a child theme | Intermediate | Your server |
| theme.json | Block themes | Developer | Bundled with theme |
| Elementor Custom Fonts | Elementor Pro | Beginner | Your server |
How do you keep added fonts fast and private?
Keep fonts fast by using WOFF2 files, loading only the weights you need, hosting fonts on your own server, and preloading the main font file used above the fold.
Loading fonts straight from Google's servers sends visitor IP addresses to Google, which some regulators have questioned under privacy rules. Hosting fonts yourself avoids that.
This is general information, not legal advice. See our guide on hosting Google Fonts locally.
Preloading your main text font helps it appear sooner. Our guide on how to preload fonts in WordPress shows how to do it without slowing other files.
Check your pages with a speed test after adding fonts. If page weight jumps, remove unused weights.
Why is your new font not showing?
A new font usually does not show because it was never applied to any text, a cache is serving old CSS, the file path is wrong, or another setting overrides it.
Work through this list:
- Apply the font. In Styles > Typography, choose it for Text, Headings or a specific block.
- Clear caches. Clear your caching plugin, CDN and browser cache. See how to clear cache in WordPress.
- Check the file path. In your browser's developer tools, look for 404 errors on font files.
- Check font names. The font-family name in your CSS must match the name in @font-face exactly.
- Check for overrides. A page builder or theme option may set a different font with higher priority.
If the font loads on desktop but not on a phone, the file format or a security header may be blocking it. Cross-origin font loading can fail when fonts are served from another domain without the right headers.
What should you do after adding a font?
After adding a font, apply it in your global styles, check headings and body text on desktop and mobile, test page speed, and remove any old fonts you no longer use.
Removing unused fonts matters. Many themes load their default fonts even when you have switched to something else. Look for a theme setting to turn those off.
Write down which fonts and weights you use and where the files live. It makes future redesigns and theme switches much easier.
Frequently asked questions
What font file types can WordPress use?
WordPress and modern browsers support WOFF2, WOFF, TTF and OTF font files. WOFF2 is the best choice for websites because it is compressed and loads faster than the others.
Can I use any font I downloaded on my WordPress site?
Only if its license allows web use. Fonts from Google Fonts are free for websites, but many commercial and free desktop fonts need a separate webfont license. Read the license before uploading.
Does adding fonts slow down WordPress?
Each font file adds a download, so many families and weights can slow pages. Using one or two families, WOFF2 files and only the weights you need keeps the impact small.
Why can't I find the Font Library in my dashboard?
The Font Library is part of the Site Editor in block themes and needs WordPress 6.5 or newer. Classic themes do not show it, so use your theme's typography options or a fonts plugin instead.
Where does WordPress store uploaded fonts?
Fonts added through the Font Library are stored in a fonts folder inside your uploads directory by default, so they survive theme switches and theme updates.
Sources
- The Font Library WordPress.org
- New Feature: Font Library Make WordPress Core
- Font Library update: storage of font files Make WordPress Core
- Typography settings in theme.json WordPress Developer Resources
- @font-face MDN Web Docs
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


