# PMTiles

Single-file archive format for tiled map data, with a JavaScript library that reads it in browsers and Node.js.


Source: https://findsoftware.frbit.cloud/protomaps/
Last reviewed: 2026-11-16
Listed since: 2026-11-16

## Record

### Links

- home: https://protomaps.com
- repository: https://github.com/protomaps/PMTiles
- docs: https://docs.protomaps.com/pmtiles/
- bluesky: https://bsky.app/profile/protomaps.com
- mastodon: https://mapstodon.space/@protomaps

### Identity

- status: active
- maintainer: Protomaps LLC
- maintainerType: company
- parent: unknown
- firstRelease: 2021
- hqCountry: unknown

### Kind

- category: graphics
- hosting: not applicable
- language: javascript
- runtime: node
- runtimeMin: not applicable
- basedOn: unknown

### Content

- contentStore: not applicable
- databases: not applicable
- adminUi: not applicable
- headlessApi: not applicable
- templating: not applicable
- i18n: not applicable

### Rendering and deploy

- runsAs: not applicable
- renderingModes: not applicable
- installMethod: npm, script tag

### License

- licenseModel: open-source
- license: BSD-3-Clause

### Releases

- currentMajor: 4
- latestReleaseDate: 2026-08-10

### Adoption

- githubStargazers: 3199
- packagistDownloads: not applicable
- npmWeeklyDownloads: 2270953
- contributors: 51
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 81
- dependentPackages: 27

### Sources

- urls: https://protomaps.com/ (read 2026-11-16)
- urls: https://github.com/protomaps/PMTiles (read 2026-11-16)
- urls: https://docs.protomaps.com/pmtiles/ (read 2026-11-16)
- firstRelease: https://registry.npmjs.org/pmtiles (read 2026-11-16)
- maintainer: https://github.com/protomaps/PMTiles/blob/main/LICENSE (read 2026-11-16)
- maintainerType: https://github.com/protomaps/PMTiles/blob/main/LICENSE (read 2026-11-16)
- language: https://github.com/protomaps/PMTiles (read 2026-11-16)
- category: https://docs.protomaps.com/pmtiles/ (read 2026-11-16)
- runtime: https://github.com/protomaps/PMTiles/blob/main/js/README.md (read 2026-11-16)
- installMethod: https://github.com/protomaps/PMTiles/blob/main/js/README.md (read 2026-11-16)
- installMethod: https://github.com/protomaps/PMTiles/blob/main/js/README.md (read 2026-11-16)
- license: https://github.com/protomaps/PMTiles/blob/main/LICENSE (read 2026-11-16)
- licenseModel: https://protomaps.com/about (read 2026-11-16)
- currentMajor: https://registry.npmjs.org/pmtiles/latest (read 2026-11-16)
- latestReleaseDate: https://registry.npmjs.org/pmtiles (read 2026-11-16)
- githubStargazers: https://github.com/protomaps/PMTiles (read 2026-11-16)
- contributors: https://api.github.com/repos/protomaps/PMTiles/contributors?per_page=1 (read 2026-11-16)
- npmWeeklyDownloads: https://api.npmjs.org/downloads/range/2026-11-01:2026-11-07/pmtiles (read 2026-11-16)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/pmtiles (read 2026-11-16)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/pmtiles (read 2026-11-16)

## Notes

PMTiles is a single-file archive format for tiled map data, with a JavaScript library that reads it in browsers and Node.js. An archive holds a tile pyramid in one file that can be hosted on a storage platform such as S3, and the reader fetches only the tiles it needs with HTTP range requests. The format is read-only, so an archive is written again in full when its contents change. The [documentation](https://docs.protomaps.com/pmtiles/) describes the archive concepts and how the library works with map libraries such as MapLibre GL JS, Leaflet and OpenLayers.

## Worth knowing

This record covers the format and the library only. The Protomaps project also runs a hosted tile API for its basemap, which is a separate service.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0
