How to open .MBTILES files on iOS
To open .MBTILES files on iOS, 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).
Step-by-step instructions
- 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).
Common 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.
- Inspect the MBTiles with GDAL (e.g., gdalinfo) or check the MBTiles metadata to determine whether it contains raster tiles or vector tiles.
- In QGIS, load it using the appropriate data source type (QGIS vector-tiles workflow is documented for vector MBTiles).
- 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.
- Open the file in a GIS/map viewer that understands MBTiles (e.g., QGIS for vector tiles).
- 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.
- Re-copy or re-download the .mbtiles file to rule out transfer truncation.
- 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).
- 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.
- Check IANA’s media type registry to confirm whether a registered type exists for your use case.
- 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.
Security note
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.