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
Before your share your style or use it in an application, you will 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 a style you share or use in production until you explicitly publish it using the Publish button.
On your Styles page, there is a Share & use button next to the name of each style listed. This button will open a modal with all the available options for sharing or using your style in an application.
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 just to show off your creative work. Click the clipboard button to copy the share URL to your clipboard. Paste it into a browser window to see your style.
If you wish to add interactions like popups, you will need to do so by creating a web application with Mapbox GL JS.
The Use > Web option provides the HTML code that is necessary to initialize your map style on a web page using Mapbox GL JS.
Your access token and style URL are provided below the code block. Use these to integrate your custom style into an existing web project using Mapbox GL JS. A style URL is how you refer to your map style in other Mapbox tools. Combined with your access token, it allows you to access and use your map with any of the Mapbox developer tools.
A complete style URL, for example mapbox://styles/mapbox/streets-v10, is made up of three components:
mapbox://styles– points to Mapbox's Styles API
/mapbox– your Mapbox username
/streets-v10– your style's unique ID
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.
You can use your Mapbox Studio style as a basemap in ArcGIS Online, Tableau, CARTO, and Fulcrum. Full instructions for each of these tools are available in the Style & use modal's Use > Third party option.
There are several other ways to use custom styles built with Mapbox Studio.
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.
Mapbox.js v3.0.1 and beyond support adding styles from Mapbox Studio, using the
See the full example in the Mapbox.js documentation.
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.