---
title: "How to create and use custom fonts in MapTiler Server | Guides | Self hosting | Map server"
description: "Import and use custom fonts within MapTiler Server maps."
---

> For AI agents: a documentation index is available at [/llms.txt](https://docs.maptiler.com/llms.txt). Markdown versions of all pages are available by appending .md to any URL.

# 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](https://www.maptiler.com/server/). We will use the [MapLibre Font Maker](https://maplibre.org/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](https://fonts.google.com/) or [Font Space.](https://www.fontspace.com/category/opentype)  
Once you have your font, you can upload it to MapLibre’s handy tool: [MapLibre Font Maker](https://maplibre.org/font-maker/) 

![MapLibre Font Maker Interface](./28813388790289_7e9b1bfabd.png)

This tool will **convert** the OTF or TTF format into one that is **compatible** with [MapTiler Server](https://www.maptiler.com/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

![](./28813388791953_6ff11aa241.png)

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.](https://docs.maptiler.com/guides/self-hosting/map-server/how-to-work-with-map-styles-in-maptiler-server)

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](./28813381925777_021cee13ea.png)

## Conclusion

With this guide, you should now be able to convert your fonts into a format compatible with [MapTiler Server](https://www.maptiler.com/server/) and apply them to your locally hosted maps.

## Useful links

[How to work with map styles in MapTiler Server](https://docs.maptiler.com/guides/self-hosting/map-server/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](https://docs.maptiler.com/guides/self-hosting/map-server/how-to-work-with-fonts-and-labels-in-maptiler-server)  
[How to add data to MapTiler Server](https://docs.maptiler.com/guides/self-hosting/map-server/how-to-add-and-host-data-in-maptiler-server)  
[Font Maker](https://maplibre.org/font-maker/)  
[Google Fonts](https://fonts.google.com/)  
[Font Space](https://www.fontspace.com/category/opentype)