Packages

mapbox-gl

3.34.2 · 3 Nov 2026SEE LICENSE IN LICENSE.txt6M / weekRepositoryHomepagenpmAtom feed

Upgrading mapbox-gl From 3.4.0 to 3.5.0

1 release in betweenevery note read

Other targets from 3.4.0Newest 3.x, Latest3.34.2
  1. 3.4.0yours
  2. 3.5.0target

Before you upgrade

Tick each one off as you go
  • breaking3.5.0

Release by release

  1. 3.5.0

    Migration needed4 Jul 202410 new · 9 fixes
    • breaking

      This release marks a significant transition for GL JS, moving from Flow to TypeScript. While we have maintained backward compatibility where possible, the community typings @types/mapbox-gl are not fully compatible with the new first-class typings. Users relying on the community typings may experience breaking changes. Please remove the @types/mapbox-gl dependency and refer to the v3.5.0 migration guide for instructions on upgrading, resolving common issues, and asking questions regarding the migration to the first-class typings. We welcome your feedback and contributions to make Mapbox GL JS better.

    • new

      Add color-theme property and Map setColorTheme method to enable colorization with a lookup table (LUT) images.

    • new

      Significantly improve performance of updateData for GeoJSON sources in dynamic mode.

    • new

      Add icon-occlusion-opacity and text-occlusion-opacity properties to fade symbols behind models and landmarks.