New Learning Moodle Theme Documentation

Last updated: September 11, 2026

Description

The theme allows you to use self-hosted fonts instead of loading fonts from external services such as Google Fonts. This gives you more control over how fonts are loaded and can help with privacy and compliance requirements.

In some countries and regions, websites may need to avoid loading fonts directly from external services due to privacy or data protection requirements. Self-hosting fonts can help you meet these requirements by keeping font files on your own server.

You can upload your own font files and then use the font in the theme's typography settings.

Add a custom font

Prepare your font file or files in the WOFF2 format.

To upload font files:

  1. Go to: Theme settings > Font > Custom fonts.
  2. Enter the font name in the "Font name" field . The font name must match the font family's name defined in the font file.
  3. Upload the font file or files.

Font file naming

You can specify the font weight and style in the file name. Use triple underscores (___) as separators and follow this format:

any-font-file-name___font-weight___font-style.woff2

For example:

font-file-normal-style___100-900___normal.woff2
font-file-italic-style___100-900___italic.woff2
font-file-bold-weight___700___normal.woff2

The theme uses the information in the file name to automatically determine the font weight and style.

Uploaded WOFF2 font files in the file manager

Use the custom font

After adding the custom font, you can select it in the typography settings.

To use the custom font:

  1. Go to: Theme settings > Typography.
  2. Open the typography section where you want to use the custom font, for example Global, Headings, or Menu.
  3. Select your custom font from the font list.

Custom font selected in the typography settings