All docschevron-rightAPI Docschevron-rightarrow-leftMapschevron-rightStyles API

Styles API

The Mapbox Styles API lets you read and change map styles, fonts, and images. This API is the basis for Mapbox Studio.

If you use Studio, Mapbox GL JS, or the Mapbox Mobile SDKs, you are already using the Styles API. This documentation is useful for software developers who want to programmatically read and write these resources. It isn't necessary for you to read or understand this reference to design or use Mapbox maps.

You will need to be familiar with the Mapbox Style Specification to use the Styles API. The Mapbox Style Specification defines the structure of map styles and is the open standard that helps Studio communicate with APIs and produce maps that are compatible with Mapbox libraries.

Mapbox styles

Mapbox Standard

Style nameStyle URL
Style image
Mapbox Standard
Mapbox Standard

To use Mapbox Standard, you need to use GL JS v3 or newer on the web and on mobile Mobile Maps SDKs v11 or newer. Unless another style URL is specified, Mapbox Standard is the default map for these SDK versions.

The underlying paradigm to the Standard style is different from other Mapbox styles. Layers in Standard are not modifiable asides from the predefined configuration options. Mapbox manages the basemap experience and only surfaces key global styling configurations - in return, you get a carefully designed, cohesive visual experience and an evergreen map, always featuring the latest data, styling and rendering features compatible with your SDK.

To learn more, you can explore the Getting started docs.

Classic Mapbox styles

The following Mapbox-owned styles are available to all accounts using a valid access token. Click a style name below to learn more about the style, or copy a style URL to use the style in a project:

Style nameStyle URL
Style image
Mapbox Streets
Mapbox Streets
Mapbox Outdoors
Mapbox Outdoors
Mapbox Light
Mapbox Light
Mapbox Dark
Mapbox Dark
Mapbox Satellite