Publish your style
Once you've finished adding data and styling your map, the next step is to add it to a web or mobile application. This section covers everything you can do with your published style.
Mapbox Studio topics covered in this section:
Add data to style
Draft vs. production style URLs
For each style you create in Mapbox Studio, there is both a draft and production style URL available:
- Use the draft style URL to quickly iterate and get feedback on your style without impacting map styles being used in applications already in production.
- Use the production style URL when your style is ready for end users in a production application.
When making edits to your style in the style editor, the updated style is saved as a draft in your account. The draft style URL will include all edits to your style up to that point. The production style URL will only include edits you have made before hitting the Publish button.
Draft style URLs are meant for prototyping and iteration — they are not cached and are heavily rate limited. Using a draft style URL in a production application could result in degraded performance and blank maps for your end users due to rate limiting. As a result, draft style URLs should not be used in production.
Before using your style in a production application, you need to publish it inside the style editor. When making edits to your style in the style editor, the updated style is saved as a draft in your account. Changes made in the style editor will not be reflected in the production version of your style until you explicitly publish it using the Publish button.
Inside the style editor, there is a Share button in the top toolbar. This button will open a modal with all the available options for sharing or using your style as either a draft or production-ready style in an application.
For both draft and production versions of your style, there are three options for using the style:
- Share: A URL that can be shared with anyone.
- Develop: Convenient access to the resources needed to use your style on various platforms.
- Download: Download a zipped folder with the style JSON and all necessary assets.
Read more about each option below.
The Share URL provides a staging address for your map style. It gives you a quick way to share your map with others to get feedback, collaborate on designs, or to show off your creative work. Click the clipboard buttonto copy the share URL to your clipboard. Paste it into a browser window to see your style.
Your style URL and access token are provided in the share modal so you can use your custom style in a web, mobile, or third party application. A style URL is how you refer to your map style . Combined with your access token, it allows you to access and use your map with any of the Mapbox products.
A complete style URL, for example
mapbox://styles/mapbox/streets-v12, contains three parts:
mapbox://styles- points to Mapbox's Styles API
mapbox- the Mapbox username of the style owner
streets-v12- the style's unique ID
If you are using the draft version of your style,
/draft will be appended to the end of the style URL like this:
mapbox://styles notation for Mapbox styles is an alias to the full Styles API URL:
Mapbox uses access tokens to associate your apps and tool usage with your account. Every account has a default public access token, but you can create new access tokens as well. You can find your access tokens on your Account page.
Toggle to the platform that is relevant to your project for related resources.
The Web option provides the resources necessary to initialize your map style on a webpage using Mapbox GL JS.
For information on using a Mapbox Studio style with Mapbox.js or Leaflet, see the Mapbox.js and Leaflet section below.
Mapbox Studio loads the
mapbox-gl-rtl-text plugin, which adds support for text in the Arabic and Hebrew languages, by default. This plugin is not bundled with Mapbox GL JS. It must be set using the
setRTLTextPlugin method in Mapbox GL JS.
iOS, Android, and Unity
The iOS, Android, and Unity options provide the resources necessary to use your map style with one of our mobile Maps SDKs.
The Third party options provide the resources necessary to use your custom map style with various third-party applications including ArcGIS Online, Tableau, CARTO, and Fulcrum.
Both Mapbox template styles and your custom styles designed in Mapbox Studio come with a WMTS endpoint that can be used to add your styles to desktop GIS applications. You can use the following endpoint with any of your custom styles:
This WMTS endpoint allows you to use this map in:
- ArcMap: Available in ArcGIS Desktop 10+. See our documentation on adding Mapbox layers as WMTS in ArcMap to get started.
- QGIS: This feature is available in QGIS 2.0+. See our documentation on adding Mapbox layers as WMTS in QGIS to get started.
Download a zip file that contains all pieces of your style, including a JSON document adhering to the Mapbox Style Specification, the sprite containing all icons and images used in the style, and all fonts used in the style. This can be stored locally, altered in a text editor, uploaded to your account, or shared with other Mapbox Studio users.
Mapbox.js and Leaflet
You can use Mapbox Studio styles with other web mapping libraries like Mapbox.js and Leaflet using the Mapbox Static Tiles API to generate raster tiles from your Mapbox Studio style.
Mapbox.js v3.0.1 and beyond support adding styles from Mapbox Studio, using the
See the full example in the Mapbox.js documentation.
Attribution and Terms of Service
Whether you're creating a custom style with Mapbox Studio or building a mobile app with the Android SDK, all Mapbox tools are governed by our attribution requirements and our terms of service. For more information about either of these requirements, contact Mapbox Support.