Open-The-File.com

Find how to open any file type

.MBTILES file extension

To open .MBTILES files on Windows, qGIS: Open QGIS and use the Vector Tiles data source option to add the local file (e.g., file.mbtiles) as a vector tiles source (if your MBTiles contains vector tiles).

To open a .mbtiles file, use a GIS or mapping app that supports MBTiles (for example QGIS for vector tiles, or GDAL tools for inspection/conversion). An .mbtiles file is a SQLite database containing map tiles plus metadata.

HomeExtension IndexGIS in indexGIS category page

Last updated: June 12, 2026

Open on your device

Choose your operating system for a dedicated step-by-step opening guide.

How to open .MBTILES files

Use these platform-specific instructions to open .MBTILES files safely.

Windows

  1. QGIS: Open QGIS and use the Vector Tiles data source option to add the local file (e.g., file.mbtiles) as a vector tiles source (if your MBTiles contains vector tiles).
  2. GDAL tools: Use GDAL utilities (e.g., gdalinfo) to inspect the dataset and confirm what it contains (raster tiles vs vector tiles) before converting or using it.
Full Windows guide

Mac

  1. QGIS: In QGIS, add the MBTiles file as a Vector Tiles source by pointing QGIS to the local file (file.mbtiles) (works when the MBTiles contains vector tiles).
  2. GDAL tools: Use GDAL utilities such as gdalinfo to inspect the MBTiles and determine its content and metadata.
Full Mac guide

Linux

  1. QGIS: Add the .mbtiles file as a Vector Tiles source in QGIS by selecting the local MBTiles database file (file.mbtiles) (for vector MBTiles).
  2. GDAL tools: Use GDAL (e.g., gdalinfo) to inspect/read the MBTiles and, if needed, convert it to another format supported by your workflow.
Full Linux guide

iOS

  1. If you need to view an MBTiles on iOS, it’s commonly easiest to transfer it to a desktop GIS tool (like QGIS) for viewing/validation first; mobile support depends on the specific mapping app and the MBTiles content (raster vs vector).
Full iOS guide

Android

  1. If your Android mapping app supports MBTiles, import the .mbtiles file as an offline tiles source; if not, validate or convert it on a desktop first using QGIS/GDAL.
Full Android guide

Security notes

  • An .mbtiles file is a SQLite database; opening untrusted databases in GIS/database tools can still trigger vulnerabilities in parsers (SQLite itself or image/vector tile decoding in the consuming app). Prefer opening untrusted MBTiles in up-to-date software.
  • MBTiles commonly embeds tile payloads (raster images or vector tile blobs). Even though it is “just data,” the embedded content is processed by decoders; malformed tiles can cause crashes in viewers or libraries.
  • Because it’s a database, an MBTiles can contain very large amounts of data; importing unknown MBTiles into a server or desktop workflow can lead to unexpected disk usage and performance issues.

If you did not expect this file

This extension is usually plain data, text, or structured content—not a program by itself. The practical risk is social engineering (a scam attachment or misleading filename). For trusted senders you rarely need heavy-handed antivirus wording; use these tools when you want an extra check on unexpected downloads.

Avast

Avast offers free and premium antivirus software that protects against viruses, malware, ransomware, and phishing. Scan files before opening them to ensure safety.

Norton

Norton 360 delivers comprehensive antivirus protection, VPN, and identity theft monitoring. Scan files for threats before opening to keep your device secure.

We may earn a commission when you use affiliate links. This supports our free file extension guides.

Can't open this file?

These are the most common causes and fixes when .MBTILES files fail to open.

Common reasons

  • Opens but shows a blank map (raster vs vector mismatch)
  • File opens as a database, not a map
  • Corrupt or incomplete tileset (errors reading tiles)
  • No official MIME type recognized in your environment

Fix steps

  1. Inspect the MBTiles with GDAL (e.g., gdalinfo) or check the MBTiles metadata to determine whether it contains raster tiles or vector tiles.
  2. In QGIS, load it using the appropriate data source type (QGIS vector-tiles workflow is documented for vector MBTiles).
  3. If your target app only supports one type, regenerate/convert tiles in the correct type using your tiling toolchain.

OS-specific troubleshooting

What is a .MBTILES file?

MBTiles is a tileset format that stores map tiles inside a SQLite database file. The MBTiles spec defines a schema and metadata conventions (e.g., tiles tables and metadata entries), and it is used to bundle tiles into a single portable file. GDAL documents MBTiles support for both raster tiles and vector tiles (PBF) stored in the SQLite container.

Background

MBTiles is designed as a practical “single file” container for map tiles, making it convenient for offline use, distribution, and packaging tiles for applications. Because it is built on SQLite, an MBTiles file can be queried and inspected with SQLite tools, while mapping software reads the tile and metadata tables to render maps.

The format is specified in the Mapbox MBTiles specification repository, which describes the expected database layout and common metadata fields used by clients. In practice, MBTiles is widely encountered in workflows that generate tiles, ship them to a desktop/mobile device, and then display them in a GIS or map viewer.

Software support varies by whether the MBTiles contains raster tiles (typically images like PNG/JPEG) or vector tiles (often Mapbox Vector Tile data such as PBF). QGIS documentation, for example, describes loading a local MBTiles database as a vector tiles source, and GDAL documents reading/writing MBTiles for tile-based raster data and notes vector tile content as well.

Further reading

Authoritative resources for more details on the .MBTILES format.

Common .MBTILES issues

Opens but shows a blank map (raster vs vector mismatch)

An MBTiles file can store raster tiles or vector tiles (PBF). If you load a raster MBTiles as a vector tiles source (or vice versa), the application may show nothing or fail to render.

  1. Inspect the MBTiles with GDAL (e.g., gdalinfo) or check the MBTiles metadata to determine whether it contains raster tiles or vector tiles.
  2. In QGIS, load it using the appropriate data source type (QGIS vector-tiles workflow is documented for vector MBTiles).
  3. If your target app only supports one type, regenerate/convert tiles in the correct type using your tiling toolchain.

File opens as a database, not a map

.mbtiles is a SQLite database file. If you open it in a generic database browser or SQLite tool, you will see tables (like tiles/metadata) rather than a rendered map.

  1. Open the file in a GIS/map viewer that understands MBTiles (e.g., QGIS for vector tiles).
  2. If you need to verify contents, use a SQLite viewer intentionally and look for the tiles and metadata tables as described in the MBTiles spec.

Corrupt or incomplete tileset (errors reading tiles)

Because MBTiles is a SQLite container, a truncated download/copy or an interrupted write can leave the SQLite database inconsistent, causing read errors or missing tiles.

  1. Re-copy or re-download the .mbtiles file to rule out transfer truncation.
  2. Open the database with a SQLite tool to confirm it is readable as a SQLite database and that expected tables exist (per the MBTiles spec).
  3. If you created it yourself, re-export/rebuild the MBTiles from the original data source.

No official MIME type recognized in your environment

Some systems rely on registered IANA media types for content handling. MBTiles may not have an IANA-registered media type, so servers/browsers may treat it as a generic binary download.

  1. Check IANA’s media type registry to confirm whether a registered type exists for your use case.
  2. If none is registered, configure your system to serve it as a generic binary type (e.g., application/octet-stream) or use your platform’s recommended custom mapping for downloads.

FAQ

Is an .mbtiles file just a SQLite database?

Yes. MBTiles uses SQLite as the on-disk container format, with specific tables and metadata conventions defined by the MBTiles specification.

Can MBTiles store vector tiles as well as raster tiles?

Yes. GDAL documentation notes MBTiles can store raster tiles and may also store vector tiles (PBF) inside the SQLite container.

How do I open an MBTiles in QGIS?

QGIS documentation describes loading a local MBTiles database file (file.mbtiles) as a vector tiles source via QGIS’s vector tile support (this applies when the MBTiles contains vector tiles).

Does MBTiles have an official IANA media type (MIME type)?

Check IANA’s official media type registry. If MBTiles is not listed there, it means there is no IANA-registered media type and you may need to handle it as a generic binary download in web contexts.

Similar file extensions

Compare related formats in the same category to find the right tool faster.