Packages

mapbox-gl

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

Your version

3.28.0

5 Aug 2026Where it was published

3.34.2 is the newest release of 3.x.

In short

1 breaking1 removed13 new5 fixed

  • breaking

    Disable text-variable-anchor when appearances are present.

  • removed

    Remove experimental flag from layer appearances.

Release note

Breaking changes

  • breaking

    Disable text-variable-anchor when appearances are present.

Features and improvements

  • Introduce experimental map.getVerticalFieldOfView(), map.setVerticalFieldOfView(), and read-only map.getHorizontalFieldOfView() and an animatable fov camera option.

  • Expose line-border-width and line-border-color as public paint properties.

  • Introduce experimental line-border-gradient property for rendering gradient borders on lines.

  • Add support for Meshopt v1 compressed models.

  • Support string color values for the model-color in a model source.

  • Add map.resetFeatureStates() to clear all feature states for a featureset or layer.

  • Expose map.getSchema()/map.setSchema() for managing the imported style's schema.

  • Extract development and debug code from the ESM bundle into a separate module.

  • Extract more model code from the ESM core bundle.

  • Extract raster-array layer as a separate ESM module.

  • Reduce the bundle size by restructuring style, program, symbol, and expression code.

  • removed

    Remove experimental flag from layer appearances.

  • Improve symbol layer performance.

  • Reduce redundant repaints and checks during initial load.

Bug fixes

  • Fix double rotation of the FF5C character in vertical text rendering.

  • Preserve live gesture when camera setter is called from inside a drag/move handler.

  • Stop overwriting the pointerEvents of markers set by the user.

  • Fix models with vertex alpha 0 appearing black.

  • Fix incorrect rendering of fill extrusions with fill-extrusion-edge-radius at low zoom levels in some cases.