[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"extension:v3:en:mbtiles":3},{"resolvedFromAlias":4,"canonicalExt":5,"ext":5,"name":6,"category":7,"categoryName":8,"updatedAt":9,"popularity":10,"summary":11,"howToOs":12,"quickAnswer":18,"answerIntro":19,"whatIs":20,"description":21,"furtherReading":22,"openInstructions":41,"commonIssues":55,"securityNotes":82,"faq":86,"aliases":99,"mimeTypes":100,"relatedExtensions":101,"breadcrumbs":146,"categoryAnchor":156,"categoryFuturePath":157,"metaDescription":158,"availableHowToOs":159,"openOnDeviceLinks":160,"cannotOpenReasons":176,"cannotOpenFixes":177,"convertOptions":178,"securityAffiliateMessaging":179,"securityAffiliates":180},false,"mbtiles","MBTiles (SQLite tile set)","gis","GIS","2026-06-12T08:55:03.182Z",35,".mbtiles is a single-file map tile package used to store tiled maps (raster or vector tiles) in a SQLite database. It’s commonly opened in GIS and mapping tools such as QGIS, GDAL-based tools, and MapTiler Desktop.",[13,14,15,16,17],"windows","mac","linux","ios","android","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.","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.","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.\n\nThe 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.\n\nSoftware 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.",[23,26,29,32,35,38],{"title":24,"url":25},"MBTiles Specification (mapbox/mbtiles-spec)","https://github.com/mapbox/mbtiles-spec",{"title":27,"url":28},"GDAL MBTiles driver documentation","https://gdal.org/en/stable/drivers/raster/mbtiles.html",{"title":30,"url":31},"QGIS Manual: Working with Vector Tiles (includes MBTiles as a local source)","https://docs.qgis.org/latest/en/docs/user_manual/working_with_vector_tiles/vector_tiles.html",{"title":33,"url":34},"SQLite Database File Format","https://www.sqlite.org/fileformat.html",{"title":36,"url":37},"OpenStreetMap Wiki: MBTiles","https://wiki.openstreetmap.org/wiki/MBTiles",{"title":39,"url":40},"IANA Media Types Registry","https://www.iana.org/assignments/media-types/media-types.xhtml",{"windows":42,"macos":45,"linux":48,"ios":51,"android":53},[43,44],"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).","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.",[46,47],"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).","GDAL tools: Use GDAL utilities such as gdalinfo to inspect the MBTiles and determine its content and metadata.",[49,50],"QGIS: Add the .mbtiles file as a Vector Tiles source in QGIS by selecting the local MBTiles database file (file.mbtiles) (for vector MBTiles).","GDAL tools: Use GDAL (e.g., gdalinfo) to inspect/read the MBTiles and, if needed, convert it to another format supported by your workflow.",[52],"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).",[54],"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.",[56,63,69,76],{"title":57,"description":58,"steps":59},"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.",[60,61,62],"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.",{"title":64,"description":65,"steps":66},"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.",[67,68],"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.",{"title":70,"description":71,"steps":72},"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.",[73,74,75],"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.",{"title":77,"description":78,"steps":79},"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.",[80,81],"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.",[83,84,85],"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.",[87,90,93,96],{"question":88,"answer":89},"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.",{"question":91,"answer":92},"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.",{"question":94,"answer":95},"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).",{"question":97,"answer":98},"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.",[],[],[102,108,113,119,125,130,135,140],{"ext":103,"name":104,"category":7,"categoryName":8,"popularity":105,"summary":106,"howToOs":107},"geojson","GeoJSON (RFC 7946) geospatial data",72,".geojson is a JSON-based format for exchanging geographic features (points, lines, polygons) and their properties. It is widely used in GIS and web mapping tools and follows the GeoJSON standard (RFC 7946).",[13,14,15,16,17],{"ext":109,"name":110,"category":7,"categoryName":8,"popularity":105,"summary":111,"howToOs":112},"shp","Esri Shapefile (geometry file)",".shp is the main geometry file in an Esri Shapefile dataset used to store vector GIS features. You typically open it in GIS software (for example ArcGIS Pro) together with its companion files such as .dbf and .shx.",[13,14,15,16,17],{"ext":114,"name":115,"category":7,"categoryName":8,"popularity":116,"summary":117,"howToOs":118},"kml","Keyhole Markup Language (KML)",70,"KML is an XML-based GIS format for showing geographic features (placemarks, paths, polygons, overlays) on maps and virtual globes. It’s commonly opened in Google Earth and is also supported by GIS tools such as ArcGIS.",[13,14,15,16,17],{"ext":120,"name":121,"category":7,"categoryName":8,"popularity":122,"summary":123,"howToOs":124},"gpkg","OGC GeoPackage (SQLite) geospatial database",55,".gpkg is an OGC GeoPackage: a SQLite 3 database file with a standardized schema for geospatial data. It commonly stores vector layers and can also store raster/tiles in the same single file.",[13,14,15,16,17],{"ext":126,"name":127,"category":7,"categoryName":8,"popularity":122,"summary":128,"howToOs":129},"osm","OpenStreetMap OSM XML (map data)",".osm is an OpenStreetMap dataset stored as OSM XML, containing map features like nodes, ways, and relations. It’s commonly opened or imported into GIS tools such as QGIS, GDAL-based software, or data-integration tools like FME.",[13,14,15,16,17],{"ext":131,"name":132,"category":7,"categoryName":8,"popularity":122,"summary":133,"howToOs":134},"prj","ESRI/Shapefile Projection (WKT CRS) File",".prj is a plain-text “projection” sidecar file most commonly used with ESRI Shapefiles to store the dataset’s coordinate reference system in Well-Known Text (WKT). You typically open it in GIS software (as part of the shapefile) or a text editor to inspect the CRS definition.",[13,14,15,16,17],{"ext":136,"name":137,"category":7,"categoryName":8,"popularity":122,"summary":138,"howToOs":139},"shx","Esri Shapefile Index (SHX)",".shx is the index component of an Esri Shapefile dataset, used alongside .shp (geometry) and .dbf (attributes). You typically open it by opening the shapefile dataset (the .shp) in a GIS app rather than opening the .shx by itself.",[13,14,15,16,17],{"ext":141,"name":142,"category":7,"categoryName":8,"popularity":143,"summary":144,"howToOs":145},"kmz","KMZ (Zipped KML) geospatial archive",45,"A KMZ file is a ZIP-compressed package used to share KML map content (places, paths, overlays), often for viewing in Google Earth and other GIS tools.",[13,14,15,16,17],[147,150,153],{"label":148,"to":149},"Home","/",{"label":151,"to":152},"File Extension Index","/file-extension",{"label":154,"to":155},".MBTILES","/file-extension/mbtiles","category-gis","/category/gis","Learn what .MBTILES files are, how to open them on every platform, common fixes, and security best practices.",[13,14,15,16,17],[161,164,167,170,173],{"os":13,"label":162,"to":163},"Open .MBTILES on Windows","/how-to/open-mbtiles-on-windows",{"os":14,"label":165,"to":166},"Open .MBTILES on Mac","/how-to/open-mbtiles-on-mac",{"os":15,"label":168,"to":169},"Open .MBTILES on Linux","/how-to/open-mbtiles-on-linux",{"os":16,"label":171,"to":172},"Open .MBTILES on iOS","/how-to/open-mbtiles-on-ios",{"os":17,"label":174,"to":175},"Open .MBTILES on Android","/how-to/open-mbtiles-on-android",[57,64,70,77],[60,61,62],[],"untrusted_source",[181,185],{"name":182,"description":183,"affiliateUrl":184},"Avast","Avast offers free and premium antivirus software that protects against viruses, malware, ransomware, and phishing. Scan files before opening them to ensure safety.","https://www.avast.com/lp-aff-consumer-store?expid=inf601",{"name":186,"description":187,"affiliateUrl":188},"Norton","Norton 360 delivers comprehensive antivirus protection, VPN, and identity theft monitoring. Scan files for threats before opening to keep your device secure.","http://buy.norton.com/aff_home?utm_campaign=en-ww_nor_n36_aff_nas_nau_nah_cj_nad_low:_sec_nat_mktc_norton_360"]