On this page

    How to create and use custom fonts in MapTiler Server

    This document will guide you through the process of creating and working with custom fonts in MapTiler Server. We will use the MapLibre Font Maker to import OTF or TTF font files and convert them into a format usable within MapTiler Server. You’ll also learn how to add and manage these fonts to customize the appearance of your maps.

    Disclaimer: Not all fonts are compatible with every language. For instance, some fonts may support Latin characters but may not render correctly with non-Latin scripts such as Arabic. It’s crucial to thoroughly test and review the final output to ensure that your chosen custom font works as expected before publishing to production, whether for global or local use.

    Creating PBF files from your font 

    The first step is to obtain your fonts in either OTF or TTF format. You may already have some in-house fonts, or you can download free fonts readily available online such as Google Fonts or Font Space.
    Once you have your font, you can upload it to MapLibre’s handy tool: MapLibre Font Maker 

    MapLibre Font Maker Interface

    This tool will convert the OTF or TTF format into one that is compatible with MapTiler Server.
    After conversion, you can download the resulting zip file.

    Next, extract the zip file into the fonts folder of your MapTiler Server directory. The folder structure will look something like this: M:\MapTiler Server\fonts

    For example, if you convert a font named “Montserrat Black” you should have a new folder with the same name in M:\MapTiler Server\fonts.

    Inside that folder, you’ll find 256 pbf files named sequentially from 0-255.pbf to 65280-65535.pbf.

    Adding the font to your map style

    Once your desired font has been added to the server, the next step is to update the style.json file for the map where you want to apply the font.

    You’ll need to specify the font in the relevant section of the style file. For more detailed instructions on how to work with map styles in MapTiler Server, you can refer to this documentation.

    To apply the font, you need to edit the text-font property for each label where you want the font to be used. Ensure that the font name matches the exact directory name, such as “Montserrat Black”.

    Example of Font Usage in Map Style

    Conclusion

    With this guide, you should now be able to convert your fonts into a format compatible with MapTiler Server and apply them to your locally hosted maps.

    How to work with map styles in MapTiler Server
    How to work with fonts and labels in MapTiler Server
    How to add a map style to MapTiler Server
    How to add data to MapTiler Server
    Font Maker
    Google Fonts
    Font Space

    Was this helpful?

    Map server guides
    How to create and use custom fonts in MapTiler Server
    Prepare custom fonts