Spec Reference | Mapbox Style Spec | Mapbox Docs

This documentation is divided into several sections, each of which describes a different aspect of the Mapbox Style Specification.

Most describe a top-level property and its associated child properties. Others document more general concepts or patterns used throughout a Mapbox style such as expressions and types. Many sections also include inline JSON examples and related resources.

Layers

A style's layers property defines all of the layers to be rendered in the style.

Expressions

An expression defines a formula for computing the value of the property using the operators described in this section.

Sources

A style's sources property defines data sources to be shown on the map.

Root

Root level properties of a Mapbox style specify the map's layers, tile sources and other resources, and default values for the initial camera position when not specified elsewhere.

Types

A Mapbox style contains values of various types, most commonly as values for the style properties of a layer.

Sprite

A style's sprite property supplies a URL template for loading small images to use in rendering background-pattern, fill-pattern, line-pattern,fill-extrusion-pattern and icon-image style properties.

Lights

A style's light or lights property provides a global light source for that style.

Glyphs

A style's glyphs property provides a URL template for loading signed-distance-field glyph sets in PBF format.

Terrain

A style's terrain property is a global modifier that elevates layers and markers based on a DEM data source.

Schema

A style's schema property is a JSON object that defines how a style can be configured.

Imports

A style's imports property is used to add other styles into the map.

Projection

A style's projection property specifies the map projection to use when rendering the style.

Other

The value for any layout or paint property may be specified as a function.

Fog

A style's fog property is a global styling effect that can be used to create an atmospheric gradient, stars, and haze.

Rain

A style's rain property is a global styling effect that can be used to add animated rain to the map.

Snow

A style's snow property is a global styling effect that can be used to add animated snow to the map.

Slots

Slots are a layer type that acts as a placeholder for custom layers added to a style.

Transition

A transition property controls timing for the interpolation between a transitionable style property's previous value and new value.

Featuresets

A style's featuresets property defines groups of style layers that are available for interaction when the style is imported from another style.

Additional Developer Resources

Mapbox Developer Discord

Developer Cheatsheet

Mapbox Support

Ask AI

Was this page helpful?