map loads

A map load occurs whenever a Mapbox GL JS Map object is initialized on a webpage. This means that people who are using your web map can toggle additional sources on and off, interact with the map, and toggle between styles without affecting your usage.

Web maps using Mapbox GL JS v1.0.0 and higher are billed by map loads. A new map load occurs every time a page loads, including every time a user reloads a page. The maximum session length for a map load is 12 hours. If a user has the same map open after 12 hours, we will count that as a new map load session.

Updating from v1.x.x to v2.x.x

The action that triggers a map load changed in Mapbox GL JS v2.0.0:

  • Mapbox GL JS v2.x.x: A map load occurs whenever a Mapbox GL JS Map object is initialized on a webpage.
  • Mapbox GL JS v1.x.x: A map load occurs whenever a Mapbox GL JS Map object is initialized on a webpage and you request a Mapbox-hosted map tile.

Before updating an existing implementation from v1.x.x to v2.x.x, please review our pricing documentation to estimate expected costs.

Related resources: