Add web fonts to your theme and the Woo360 plugin

Both Woo360 Theme and the Woo360 plugin have built-in system fonts and Google fonts, but you can also add any other web fonts for which you have a license to generate and use web fonts.

These instructions should work with most themes, but instructions are also included on how to add the fonts to the font selection fields in Woo360 Theme's Customizer and the Woo360 plugin.

Note: This article applies to web fonts other than Google fonts and Adobe Typekit fonts. See the Related Articles below for more information about loading those types of fonts to work with Woo360.

There are three steps to using web fonts:

  1. Prepare the web fonts and upload them to your website
  2. Load the fonts with CSS
  3. Define where the fonts will be used

You don't need to be a developer to accomplish this task, but you should know how to upload files and feel up to modifying your site's CSS and your child theme's functions.php file with code and modifications provided here. You should also have some basic familiarity with fonts and font file types.

The article contains the basic set of steps to load and use a web font, using a simple example of adding a single font with one style. See the Related Articles below for a complex example of adding a font with multiple styles and weights.


Prepare and upload the set of web fonts

  1. If you don't already have a web font file set (.woff and .woff2 files) for the font you want to use, you can create one from desktop fonts (.otf or .ttf) using the Font Squirrel Web Font Generator or various web font converter apps.
    Make sure you have an appropriate license to use your font this way.
  2. After you have generated the kit, upload the .woff and .woff2 files from it to your website. You can upload your font files anywhere, but a good place to put them is in a folder called fonts in your child theme folder. For the Woo360 child theme, this is the path:
    We'll use this location in the next procedure.

Tip: Older web font file formats like .eot, .svg, and .ttf are not required with current browsers, but if you are in a situation where your site will be accessed by older browsers, you can add them as well.


Load the font files with CSS

The @font-face rule in CSS3 specifies the location of web fonts and loads them.

  1. Go to the location on your site where you can add CSS rules that apply site-wide.
    In this example, we'll use file paths that will work for code placed in Appearance > Editor > style.css.
    See this article about where to add custom CSS rules.
  2. If your web fonts kit includes a CSS stylesheet, copy all the @font-face rules in that file and paste into your editor.
    Otherwise, start with the following example.

  1. In the code you've inserted, modify the url lines in the src attribute if necessary to include all and only the file types that you uploaded, with the correct file names.
  2. Modify the url path if necessary to make it relative to the stylesheet file location.
    The fonts/ path in this code example shows the correct path for a fonts subdirectory in the child theme when you're adding the CSS to the child theme's style.css file.
    Tip: If you use Customize > Additional CSS to add this CSS rule, the CSS is in the database, and the correct relative path starts with wp-content. For the Woo360 child theme, the correct path would be wp-content/themes/bb-theme-child/fonts/.
  3. Change the value of font-family to what you want to appear in the font selection list in Customizer or the Woo360 plugin. It's also what you'll see listed as the font when you inspect the element in your browser.
    For example, in the example here you could change 'forza-book' to 'Forza Book'.
    Note: If you plan to insert the font into the Customizer list, don't use hyphens for the font-family value.

Tip: See the Related Articles below for further CSS changes if you're adding multiple fonts or font weights.


Specify where the font will be used

There are several options to specify where the font will appear. For the Woo360 Theme, you can add the font to the font selection list in the Customizer, where it appears in the list of system fonts. You can also add the font to the Woo360 modules that allow font section, such as the Heading module.

For other themes, or to have more control about exactly where the font appears, you can use CSS rules.

Here are the options. You can implement any or all at the same time.

  • Option 1: Add code so the font appears In all of the font selection lists in Woo360 Theme's Customizer
  • Option 2: Add code so the font appears in all of the module font selection lists in Woo360
  • Option 3: Add CSS rules to specify that the font is used for particular HTML elements, IDs, or classes


  • You may need to publish and clear your browser cache to see the web font as you complete these steps. Some browsers are particularly tenacious in holding onto fonts even when the cache is cleared. If you suspect that, try looking at the published page in another browser.
  • The fonts will appear at the end of the system fonts list, not in alphabetical order.

Options 1 and 2: Add code so the font appears in Customizer and Woo360 modules

Add a single function, then use filters to add the font to Woo360 Theme's Customizer or Woo360 modules or both. This procedure shows how to add the code for either or both options.

  1. Open the Woo360 child theme's functions.php file in a text editor on in the WordPress admin panel at Appearance > Editor.
    For Woo360 Theme, this file is located at wp-content/themes/bb-theme-child/
  2. Add the following code at the end of the file.

  1. Change the $system parameter to match the font-family value you used in the CSS rule in the previous procedure.
    If your CSS has more than one font family, see the complex example in the Related Articles below.
  2. Change the fallback font list if you want. For example, if you're adding a serif web font, you might want to change the fallback to the following:
    "fallback" => "'Times New Roman',Times, serif",
  3. Change the font weight to match the weight of your web font. For example, the CSS for Forza Book in the previous procedure has only one weight: font-weight: normal;, which corresponds to a font weight of 400. Here's a list of the standard correspondence with font weight names and their numerical weight value from the Mozilla Developer site.
Value Common weight name
100 Thin (Hairline)
200 Extra Light (Ultra Light)
300 Light
400 Normal
500 Medium
600 Semi Bold (Demi Bold)
700 Bold
800 Extra Bold (Ultra Bold)
900 Black (Heavy)


  • These font weight correspondences are not set in stone, and you may want to experiment with numerical values to get the font weight and fallback font weight looking the way you want. If you do a web search for font weight, you'll find some interesting articles on the subject.
  • Usually fonts with more than one weight are delivered in a separate web font file for each weight, with a different @font-face CSS rule for each weight. If you only have one font file, you can still add more than one weight to the code above, and you will see a difference in the display, but in general that's not a good idea, for the reason that the font weights will be generated by the browser, and they won't look the same as a font weight that the font developer created. See the Related Article with the complex web fonts example for information about how to incorporate fonts with separate files for each weight.

Option 3: Add CSS rules to determine where the web font is used

  1. Go to the location on your site where you can add CSS rules that apply site-wide, in our examples here it's the style.css file for your child theme in Appearance > Editor.
    See the article about where to add custom CSS rules.
  2. Add rules to show where you want the font to be used, as in this example. Substitute the name of your custom font family from the previous rule. You can use different fallback fonts besides Verdana, Arial, and sans-serif.