Output formats: GeoPackage, MBTiles, folder

When you’re processing your data with MapTiler Engine, one of the settings you need to specify is the output format. It means the format of the entire tileset, which is the container file containing the map tiles created from your data. This page explains the available formats and helps you choose the best one for your needs.

Tiling output formats

GeoPackage

GeoPackage is an international open standard, compatible with many viewers and tools. It can contain a mix of formats, such as JPG and PNG tiles, and supports storing metadata. Combining multiple tilesets into one GeoPackage file is also allowed.

MBTiles

MBTiles is an open standard developed by Mapbox. Like GeoPackage, it’s a single file, but has a few limitations: It can only contain tiled data, it doesn’t support mixing formats within one tileset, and it can take just one tileset as input.

The maximum zoom level for MBTiles is currently limited to 22. If you need a larger zoom, use GeoPackage.

Folder with tiles

A folder with tiles contains a structure of subfolders for specific zoom levels. This format is suitable for self-hosting. Compared to single-file formats (GeoPackage, MBTiles) it takes longer to upload a folder to the hosting server, but once it’s there, it provides a faster response time.

Google Earth KML

Additionally, we offer the KML format to generate map tiles compatible with Google Earth.

  • For smaller maps, any format will work fine. If unsure, go for GeoPackage.
  • For larger maps, use GeoPackage and host your tiles in MapTiler Cloud for fast and stable access.
  • If you’re building maps for mobile devices, choose a single-file format (GeoPackage or MBTiles).
  • If you plan to use own map hosting, folder with tiles is best for fast access to the map.
  • If you need map tiles for Google Earth, choose KML.

Generally, if you don’t have any special requirements such as compatibility with specific software tools, GeoPackage is a safe universal choice.

Format comparison

  GeoPackage MBTiles Folder with tiles
Format structure Single file (.gpkg) Single file (.mbtiles) Folder with files
Mixed contents allowed?
Output coordinate system Any incl. national Global Mercator (EPSG:3857) Any incl. national
Direct upload to cloud
MapTiler Server support
On this page