It's better when it's simple

User Tools

Site Tools


FontFace Plugin

Compatible with DokuWiki

  • 2023-04-04 "Jack Jackrum" unknown
  • 2022-07-31 "Igor" unknown
  • 2020-07-29 "Hogfather" no
  • 2018-04-22 "Greebo" yes

plugin Embed fonts (via uploaded fonts or Google Fonts)

Last updated on

Similar to googlefonts

Tagged with fonts, style, typography


Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.

:!: External requirements: If you're not using a Google Font, then the used font needs to be uploaded into the plugin's “./fonts/“ directory first.

To help you decide on the technique, see Comparison of web fonts solutions on

Uploaded fonts (@font-face)

You need to upload at least two files into the plugin's “fonts” directory to accommodate the majority of all the different browsers:

  • <fontFile>.ttf
  • <fontFile>.woff

Optionally you can also add:

  • <fontFile>.eot
  • <fontFile>.svg
  • <fontFile>.woff2

Here you will find ready-made font packages which will already contain all four of them:

Google Fonts

You don't need to upload any files. You can use any of the fonts listed here:

You can add variants into the “fontFile” option, e.g. 'Expletus+Sans:regular,bold'.

Configuration and Settings

  • technique: Font embedding technique, with a choice of 'fontface' (Uploaded fonts) and 'google' (Google Fonts)
  • fontFile: Font file name (for uploaded fonts: without extension; for Google fonts: what comes after ”?family=”, see instructions)
  • fontName: Font name (as used in CSS)
  • elements: For which elements should the font be used? (comma separated, not needed when font is used in other CSS files)
  • genericFamily: Generic font family (serif, sans-serif, monospace, cursive, fantasy)
  • fontFile2: Second font file name
  • fontName2: Second font name
  • elements2: For which elements should the second font be used?
  • genericFamily2: Second generic font family

Go Admin menu > Configuration manager > Font face > Do your changes > Save.


Change Log

Known Bugs and Issues & ToDo/Wish List

Have a look at bugs, feature requests and ToDos in the bug tracker.


Before reporting any issues (bugs or requests), please first take a look at the FAQ on plugin problems.

You can report any issues either on the Issue Tracker or here in this section.

Having some trouble getting this working 100% with Google Ubuntu font. These are my settings:
Google Font API
fontFile: <link href=',400italic,700,700italic' rel='stylesheet' type='text/css'>
fontName: font-family: 'Ubuntu', sans-serif;
headings: h1 only checked
addStyles: checked
genericFamily: sans-serif

The font appears on the site, but bold and italic do not work. It's probably something simple in the setup that I'm missing but I can't see what it is. Suggestion?

The settings should be the following instead:
fontFile: Ubuntu:400,400italic,700,700italic
fontName: Ubuntu
Anika Henke 2011/08/06 12:46
I have now clarified the config options in the config manager (and on this page). — Anika Henke 2015-04-05 15:33

How can i use

Early access Google fonts are currently not supported, sorry. You could add it yourself to the meta.html file (if your template supports that). — Anika Henke 2015-04-05 15:33

possible bug - fonts are being served from local plugin directory. When 1st going to my site, the fonts don't load (start.txt) page. But when you navigate to another page, they load fine and then will also load on the start.txt page. Might be an issue with other items getting loaded into the browser before the fonts? site name & p.claim should load as fonts from the font directory.

I have the same problem. I use to check the performance of site and I see this issue that some .woff fonts not loaded. I have this warning: The following requests are returning 404/410 responses. Either fix the broken links, or remove the references to the non-existent resources. It seems there is a problem with plugin! — atronoush 2015-09-11 14:36
I cannot reproduce this locally. And I cannot check the above URL as it doesn't use DokuWiki anymore. Do you have any URL you can share where this issue appears? — Anika Henke 2016-04-06 21:01
plugin/fontface.txt · Last modified: 2023-10-30 23:08 by Klap-in

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki