Mapbox GL JS Pricing

• Billed by Map Loads for Web
• See rates and discounts per map load in the pricing page's Sessions & user prices section

How Map Loads Work

A map load occurs whenever a Mapbox GL JS Map object is initialized on a webpage. Users can interact with the map (toggle layers, zoom, pan, switch styles) without incurring additional charges. The maximum session length for a map load is 12 hours; after that, a new session (and map load) is counted.

For tips on managing costs, see the Manage your web map costs guide.

Upgrading from Older Versions

If you are using Mapbox GL JS v1 or v2, we recommend upgrading to v3 for the latest features, security, and pricing model. See the install guide for help installing the latest version.

Legacy Pricing (v1 and v2)

• v2.x.x: A map load occurs whenever a Mapbox GL JS Map object is initialized.
• v1.x.x: A map load occurs when a Map object is initialized and a Mapbox-hosted map tile is requested.

For versions older than v1, see the legacy pricing documentation.

Additional Resources

• You can check your Mapbox GL JS usage and billing details in the console statistics panel.
• Contact Mapbox sales for enterprise or high-volume pricing.

Was this page helpful?