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
Mapbox Standard is in public beta and will only work with GL JS v3 or Maps SDK v11 or newer. All features and workflows are subject to potential changes.
| Style name | Style URL | Style image |
|---|---|---|
| Mapbox Standard | mapbox://styles/mapbox/standard-beta |  |
The latest versions of our web and mobile renderers now in public beta are required to use the Mapbox Standard style. We’ve provided migration guides for GL JS v3 and Mobile Maps SDKs v11 for iOS and Android on GitHub. The guides include new version update dependencies, steps to update, and guidance for adding new features to Mapbox Standard.
Layers in Standard are not modifiable asides from the configuration options mentioned in the migration guides at the moment. The underlying paradigm to the Standard style is different from the classic core styles. 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. During the beta phase, we are piloting these configurations - we welcome feedback on the beta configurations.
Classic Mapbox styles
The following classic 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 name | Style URL | Style image |
|---|---|---|
| Mapbox Streets | mapbox://styles/mapbox/streets-v12 |  |
| Mapbox Outdoors | mapbox://styles/mapbox/outdoors-v12 |  |
| Mapbox Light | mapbox://styles/mapbox/light-v11 |  |
| Mapbox Dark | mapbox://styles/mapbox/dark-v11 |  |
| Mapbox Satellite | mapbox://styles/mapbox/satellite-v9 |