Mapbox Studio Interface
Interface layout
Mapbox Studio has a few key elements:
- Layers panel: A panel on the left side to add custom layers and style them. You can also switch to the Global tab to adjust root-level properties like the style's projection, and add features like Snow and Rain.
- Imports panel: A panel on the bottom-left to choose the basemap and customize it. Choose between Mapbox Standard and Mapbox Standard Satellite, and switch between color themes.
- Map canvas: The main map in the center of the editor. You can click on the map to see all custom layers at a single point.
- Toolbar: Top-level menu to adjust style settings, manage icons and fonts, export an image to print, and publish your style.
Layers
A layer is a styled representation of data of a single type (for example fill, line, or symbol) as defined in the Style Specification. Layers make your data visible on the map. You can create multiple layers from the same data and you can filter data by attributes for styling in a layer. You can also add a background layer to fill the canvas with a color or pattern which will apply across the whole world.
You can access the Layers list by clicking the Layers tab in the upper left of Mapbox Studio. There are several options for managing layers at the top of the list, including:
- Add new layer and choose "Custom layer…".
- Duplicate a layer to create a copy of an existing layer.
- Group or Ungroup layers to style them individually.
- Hide and Show layers.
- Delete layer to permanently remove a layer.
You can undo this using
CTRL + Zin the current session, but this cannot be undone after you close your style. - Reorder layers by clicking and dragging the next to each layer list item.
Add layer
There are a few options when you add a custom layer to your style: Source, Upload data, and Add tileset by ID.
These options allow you to add a layer that contains specific shapes (polygons, lines, or points) that cover part of the map. A layer from data comes from custom data that you have added to your Mapbox account.
There is a limit of 15 unique sources permitted in styles saved in your Mapbox
account. This count includes Mapbox tilesets like Streets or Terrain. If you
reach the 15 source limit, you will see an error, Failed to update style.
This limit is related to sources, not layers. To reduce the number of sources
needed, consider combining data before uploading and using filters in the
style editor to create different layers from the same source. For more
information on source limits see our Source limits in the Mapbox Studio
styles
troubleshooting guide.
Source
The Source menu is the default option for adding a new layer to your map. Each layer needs data to work with, otherwise the style rules would not be applied to anything. To specify data for the layer, choose a source from the list of available tilesets used in your map style (Active sources), as well as a list of tilesets that are in your account but not used in the current style (Unused sources). You can use the search box to find a tileset.
Vector sources: If you select a vector source, you'll have the following options:
- Type: allows you to select the type of layer to create either fill, fill extrusion, line, circle, symbol, heatmap, or raster data types.
- Filter: allows you to limit features that are displayed in a layer based on data properties or geometry type.
- Zoom extent: sets the
min(start) zoom andmax(last) zoom to which you data is viewed on the map (learn more about manually adjusting zoom extents).
On the canvas, you will see a preview of your data. You can click to select and view the data on the map. Hover over the data to see what data subset is below and click the Select button to populate that data into the layer you are creating.
Raster sources: If you select a raster source, your layer will automatically be assigned the Raster type. The Zoom extent option will also be available to set the min (start) zoom and max (last) zoom to which you data is viewed on the map.
RGB-encoded DEM sources: If you select an RGB-encoded DEM source, your layer will automatically be assigned the Hillshade type. The Zoom extent option will also be available to set the min (start) zoom and max (last) zoom to which you data is viewed on the map.
Upload data
Upload data to use with a layer with the Upload data option. You can upload data in the most popular geospatial formats like GeoJSON, CSV, and Shapefile up to 300 MB. For a full list of supported file types and transfer limits, see the list of supported file types.
Add tileset by ID
Add a tileset to your style using its unique tileset ID. Choose the Add tileset by ID option, then enter the tileset ID in the format username.identifier. To find the tileset ID for a specific tileset, go to your tilesets page. Click the options menu to the right of a tileset's name to find its tileset ID.
Background & sky layers
The background and sky layers are the only layer types without an associated source tileset.
Click Add new layer and choose "Background layer" which adds a layer with a fill that covers the whole world. Read more about background layers in the 'Style a layer' section below
Click Add new layer and choose "Sky layer" which adds a layer with a fill that covers the sky above your map's horizon line. Read more about sky layers in the 'Style a layer' section below.
Filter layers
Click Filter layers to show and hide layers in the layer list. You can filter by layer name by typing in the search bar or you can filter by value, layer type, or vector type.
- Filter by value options include Colors, Images and patterns, Fonts, Text fields, Text options, Icon options, Symbol placement, Line widths, Line options, and Fill options.
- Filter by layer type options include fill, line, symbol, circle, fill-extrusion, and background.
- Filter by vector layers options include all source layers.
Style a layer
Each layer can be styled individually by clicking on the name of the layer in the Layer list. There are several layer types to choose from, which are listed below. Each layer type has a unique set of layer properties that can be specified. There are a few options for specifying property values. You can pick values individually, based on a data attribute, based on the zoom level, or the value of another property.
Override
If a layer is controlled by a component, you can override the layer styling directly by modifying its styling properties. When you override a property, it will only affect one layer property for that specific layer. Other layers controlled by the component will not be affected.
Styling layer types
Fill layer
A fill layer is a style layer that displays data as filled shapes. Fill layers are typically used for setting the style of the insides of polygon features, but any feature type (polygon, linestring or point) can be styled with a fill layer.
For an example of fill layer styling, see the Make a choropleth map tutorial.
To add a pattern to a fill layer in Mapbox Studio:
- Click Images in the top toolbar.
- Click Upload SVG image.
- Select the desired fill layer from the layers panel on the left side of the style editor.
- Click the Pattern field.
- Click to select the desired image.
Fill-extrusion layer
Fill extrusion layers can be applied to sources containing polygon features to create 3D polygons. You can use a fill extrusion layer to add a 3D building layer in your style using the building source layer in the Mapbox Streets tileset.
Switch to the 3D tab and select "Light" to control the color, direction, and intensity of the lighting source on fill extrusion layers.
Line layer
You can style line layers to various widths, colors, and patterns. There are also advanced options for dash arrays and blur effects. For the most part, line layers are heavily styled and transitioned between zooms. You can also duplicate layers and filter your data for more styling control.
To add a pattern to a line layer in Mapbox Studio:
- Click Images in the top toolbar.
- Click Upload SVG image.
- Select the desired line layer from the layers panel on the left side of the style editor.
- Click the Pattern field.
- Click to select the desired image.
You can also select a previously-uploaded image from this panel.
Circle layer
A circle layer is a style layer that displays data as circles. You can use circle layers to represent scaled or interactive data, and you can use them with data that is mostly point features. In the styling panel for the layer, click the input box for each property to change its value. Hover over a property name in the panel to see its definition.
Style by filter
Circle data can show varying data values. You can make separate circle layers, filter by an attribute in your data, and style each based on the data attribute.
For example, to style earthquake data by magnitude, you can:
- Create three layers each using earthquakes as the data source.
- Filter the data based on magnitude (small, medium, large).
- Define different style properties for each one, styling higher-magnitude earthquakes as larger, darker circles.
This data can also be re-styled on-the-fly in your map with Mapbox GL JS based on user interaction or attributes in the data.
Symbol layer
Symbol layers are the most complex style type in Mapbox Studio. The symbol layer type offers detailed typographic styling options for your labels and map data. Symbol layer styling is separated into four main groups: Text, Icon, Position, and Placement.
Text
Control the typography contained on your layer in the Text section.
Fonts: You can only set fonts on symbol layer types. Custom fonts can be uploaded using the Fonts toolbar item on the left of the style editor. Set fonts from the Style tab of each symbol layer, under Text, in the Font input field. Each list of unique font pairings between primary and fallback font(s) will create a new fontstack.
A fontstack is an ordered list consisting of a primary font and optional fallback font(s). An example fontstack:
"Open Sans Regular", "Arial Unicode MS Regular"
When your primary font has missing glyphs, the text will be rendered in the fallback font instead. The default fallback font set by Mapbox Studio is Arial Unicode MS Regular. Unicode fonts include more glyphs than conventional fonts, allowing for better multilingual coverage.
Language: When building a map from a Mapbox Standard or Mapbox Satellite, map labels will appear in English by default. You can change the language of your map's labels directly in Mapbox Studio. Mapbox Standard or Mapbox Satellite use the Mapbox Streets vector tileset for map features. For a list of languages available, see the Mapbox Streets vector tile reference.
How to change languages:
- Create a new style or edit an existing one in Mapbox Studio.
- Select the layer that contains the labels you'd like to edit.
- Under the Text tab, click the current value in the Text field. A panel will appear with all language options for the layer.
- Click the desired language; the map will update on select.
Mapbox Studio loads the
mapbox-gl-rtl-text plugin by
default. This plugin adds support for text in the Arabic and Hebrew languages,
which are displayed right-to-left.
Icon
Define Maki icons that are available within Mapbox Studio or add your own custom icons in the Icon styling section. To add an image to a symbol layer in Mapbox Studio:
- Click Images in the top toolbar.
- Click Upload SVG image.
- Select the desired symbol layer from the layers panel on the left side of the style editor.
- From the Style tab select the Icon tab.
- Click the Image field.
- Click to select the desired image.
Position
Position styling allows you to choose alignment, rotation, and offset for your icons and text.
Placement
Placement styling controls placement of symbols, how symbols rotate on a map, and collision behavior for text and icon symbols among each other.
Heatmap layer
A heatmap is a data visualization in which a range of colors represent the density of points in a particular area. Adding a source layer as a heatmap layer allows you to represent the layer's features in terms of their proximity to one another. Heatmap layers in Mapbox Studio have several configurable properties that allow you to customize your heatmap:
-
color: Defines the heatmap's color gradient, from a minimum value to a maximum value. You can adjust the density and color of each stop individually, as well as add and delete stops. For inspiration on color choices for your heatmap, try Color Brewer. -
opacity: Controls the global opacity of the heatmap layer. -
radius: Sets the radius for each point in pixels. As the radius number increases, the heatmap will get smoother and have less detail. -
weight: Measures how much each individual point contributes to the appearance of your heatmap. Heatmap layers have a weight of one by default, which means that all points are weighted equally. Increasing the weight property to five has the same effect as placing five points in the same location. You can use the Style across data range and Style with data conditions options to set the weight of your points based on specified properties. -
intensity: A multiplier on top of the weight property. Intensity is primarily used as a convenient way to adjust the appearance of the heatmap based on zoom level.
Raster layer
Raster layers are created from GeoTIFF sources. GeoTIFFs are georeferenced images, and the available style properties include options you may associate with editing images, like opacity, saturation, contrast, and brightness.
Hillshade layer
Under the available sources when you create a new layer there's a new raster-dem source: Mapbox Terrain-DEM. When selected, it uses the hillshade layer type to provide many properties to style it.
Background layer
Background layers cover the full extent of your map canvas but stop at the horizon. You can create as many background layers as you want. To create textures for your map style, use multiple background layers.
Style options for background layers include:
As patterns are created from tiled images, you can upload a custom SVG image to create a pattern effect in your map. To add SVG images:
- Click Images in the top toolbar.
- Click Upload SVG image.
The image will then be uploaded to your style and available for use on any layer.
Sky layer
Sky layers are no longer supported. Use the Atmosphere property instead in the Global tab to adjust the sky color.
Sky layers cover the sky above your map's horizon line. The horizon line will be visible when your map is pitched above around 70°. Sky layers may be placed anywhere in your style's layer order and will not interfere with other types of style layers, but multiple sky layers do stack on top of each other.
Layer properties
The available properties for each layer vary by layer type. You can learn about the available properties for each layer type in the style editor by clicking Details.
Follow the links in the sections below to read more about the properties available for each layer type in more detail in the Mapbox Style Specification.
Value options
You can specify the values for each available property individually for each layer using the Style panel. You can also quickly match the values to the values in other layers using Apply existing value, set a value that changes based on zoom level, a data range, or data conditions, or create and use a custom formula to style a layer.
Set value
Click on each property to edit the value directly.
Style across zoom range
You can choose style properties based on zoom level by choosing Style across zoom range. Values can be specified for any number of stops at any specified zoom level.
This is useful where contrast at high zoom levels requires different colors to have the same effect at lower zoom levels or to slowly fade in features that appear at higher zoom levels. Here's an example from our Create a custom style tutorial:
Rate of change
There are several different options for the rate of change:
Linear: By default, the rate of change is linear, meaning a difference of one zoom level increment will increase or decrease a value by the same amount.
Exponential: A linear rate of change can be logical for many properties, but since objects in perspective increase in size exponentially as they get closer, the exponential option allows ramps to have a different base, meaning that you can customize the curve of how much a zoom level increase affects a property change over time. For example, you might visualize the population of counties in a state by proportionally scaling the layer's Color property from yellow to red for populations between 0 and 10 million people.
Cubic Bézier: The cubic-bezier option interpolates using the cubic Bézier defined by the given control points. This can be used to create non-linear, non-exponential effects like the to CSS transition properties ease-in and ease-in-out.
Step: The step option produces discrete, stepped results by evaluating a piecewise-constant function defined by stops. This option is helpful if you want complete control over the property values used in defined intervals rather than interpolating values between stops. For example, you might visualize the population of counties in a state by assigning the color yellow to counties with less than 500,000 people, orange for 500,000-1,000,000 people, and red for counties with more than 1,000,000 people.
Here's an example of interpolating from data with a stepped rate of change from the Make a choropleth map with Mapbox tutorial:
Style across data range
Style properties can be applied based on the value of a tileset field by choosing Style across data range. To use Style across data range, you must have a numeric data field for which you can create stops. This option is not available for every style property. For example, you can interpolate from data for the color of fill layers, but not for patterns.
Style with data conditions
Add conditional logic to your styles with Style with data conditions. Apply a style property to all features in a layer with a given data field value. The value in this field can be a string, number, or boolean. You can also use multiple values in each conditional statement.
For example, in the Mapbox Streets style, landuse types are styled by class. If class is equal to park or pitch, the feature's fill color is green. If the class of a feature is equal to hospital, the feature's fill color is pink. Another condition is applied if the class is equal to school, and there is a fallback value for any feature whose class field does not match any of the conditions (or does not exist at all).
Use a formula
The formula editor includes a full library of expressions with inline documentation for each expression. Use the formula editor for any expression that varies from the patterns used in the Style across zoom range, Style across data range, or Style with data conditions options, including any expression that uses math.
Below is an example of a formula that converts units in Mapbox Terrain's contour layer from meters to feet.
Reset value to default
Remove any data or zoom-based styling by clicking Reset value to default.
Apply existing value
Use Apply existing value to edit the value to match an existing value. Scroll through other layer properties to match the current layer to other layers in the style.
Edit property as JSON
Mapbox Studio allows you to edit a layer's JSON directly. The JSON editor will facilitate workflows for advanced users and early adopters who want to use features not yet supported by the graphical interface, such as identity functions. To use this feature, select a layer and choose JSON on the bottom of the layer properties.
The JSON editor can be toggled for any type of value. It will be open and cannot be closed if you have entered a value that can only be edited in the JSON editor.
Select data
There is a Select data panel for each layer. You can find it by clicking on the layer in the Layer list and then clicking the Select data tab. There are several options available to change the underlying data source.
These are the same options that are available when adding a new layer from data to your style.
Source
This shows the tileset source that is used in the layer. Click on the name of the tileset to change the source to another tileset from your Mapbox account. The source can be either a vector tileset or a raster tileset. The remaining properties available on the Select data panel will vary based on whether the source tileset is a vector or raster source.
Type
For layers with vector sources, the available source types are:
-
Fill
-
Fill-extrusion
-
Circle
-
Line
-
Symbol
-
Heatmap
Some tilesets have a combination of points, linestrings, and polygons. Use filtering by geometry type to have your layer style rules apply to only features of the selected geometry types.
For layers with raster sources, the only source type is Raster.
Filter
The filter option allows you to limit the features that are displayed in a layer based on a data property or geometry type.
When you filter by data field, you're styling the layer based on a smaller segment of the tileset based on its attributes. This can be useful to highlight specific features in a tileset, or you can use it to classify data into sequential groups using multiple layers.
To filter data based on field value:
- Click + Create filter to bring up a list of data fields in your tileset (including geometry-type).
- Select the data field you would like to filter by.
- After the new Data field is added to your filter list, use the dropdown to specify how you would like to construct the filter. Options include is, is not, **
>** (greater than), **<** (less than), **>=** (greater than or equal to), and **<=** (less than or equal to). - Click inside the box to define the value to apply to the filter. If you are using Mapbox data, a drop-down menu of potential values appears. If you are using custom data, you have to type in the value.
- Click + Add another condition to add an additional filters.
Zoom extents
Set a minimum and maximum zoom. This will only work if tilesets exist at a specific zoom levels. For more information on adjusting the zoom extent of a tileset, read our troubleshooting guide.
Manage styles
From the Mapbox Studio tab you can create, manage, and edit any of your styles. If there are more than 25 styles in your account, the style you would like to edit may not be visible when you first load your styles. You may need to use the search bar or navigate to the next page of styles to find your style.
New style
From the styles page, you can create a new style to be edited in the style editor. Click New style and by using the default settings, a style based on Mapbox Standard will be created.
If you have already downloaded a Mapbox Studio style, you can upload it to
Mapbox Studio by unzipping your compressed style and then
uploading the style.json file. All sprites, fonts, and other assets relating
to your style will be referenced when your style uploads successfully. There is
a limit of 15 unique sources permitted in styles saved in your Mapbox account.
This count includes Mapbox tilesets like Streets or Terrain. If you reach the 15 source limit, you will see an error, Failed to update style. This limit
is related to sources, not layers. To reduce the number of sources needed,
consider combining data before uploading and using filters in the style editor
to create different layers from the same source. For more information on source
limits, see our Source limits in the Mapbox Studio
styles
troubleshooting guide.
Search styles
Use the search bar to filter or reorder your list of styles so they are easier to find and manage.
- Search styles: You can search for styles by name or style ID.
- Sort styles: You can sort styles by name, date created, or date modified.
Menu for each style
Click on the menu next to each style to see options for altering and using that style. Read more about what each menu item does below.
Details
Click Details to see a preview of this style and see options for editing and managing this style.
Duplicate
Create a new style with the same layers and data as the existing style. The new copy will have a unique style ID.
Replace
Upload a new style and replace the existing version. The file you upload must be a JSON document adhering to the Mapbox Style Specification that references an available sprite containing all icons and images used in the style and all fonts used in the style. You cannot replace a style with one that does not reference an available sprite or font stack.
Make public or private
Choose whether a style should be private or public. If a style is public, the style URL can be used by any Mapbox user with their access token. But, only the owner of a style can make changes or delete a style, even if it's public. If a style is private, the style URL can only be used with an access token from the owner's account. By default, new styles created in Mapbox Studio are private.
Delete
You can permanently delete a style from your account at any time. Deleted styles may not be recovered.
Revert to last publish
Roll back changes to the last time you hit the Publish button in the style editor. This cannot be undone. You will lose any changes made between the current publish and the last publish.
Style URL
Any time you create a style with Mapbox Studio it generates a style URL. The style URL allows you to reference that specific style with the Mapbox GL JS API or native SDKs.
Map canvas
All changes made to your style will appear on the map in the center of the style editor. You can interact with the map to see all custom layers at a single point. When the Select data panel is open, you can inspect individual features from the selected tileset to view their properties.
Search places
magnifying glass icon allows you to search for locations on the map. Type in what you're looking for and select the result and search will take you to the exact location. This search is powered by the Mapbox Geocoding API.
Toolbar
The toolbar is always along the top of the screen in Mapbox Studio.
Print panel
Read the Mapbox print policy before printing any Mapbox maps. Print maps require appropriate Mapbox attribution.
Click Print to toggle the print panel on and off. Position your map and specify Print export settings in the print panel. Settings include image dimensions (in inches or centimeters), resolution (in PPI), and file format (PNG or JPG). The maximum image export is 8,000 px by 8,000 px. Use the Preview section to make sure that the print shows your desired image. When you have adjusted the size, resolution, and format to your liking, click the Export button.
Mapbox Studio offers 100 free high resolution image exports per account to all users. Your use of the Mapbox Studio print export option will not be reflected on your invoice. After 100 exports have been used on your account, you will no longer be able to access the print panel. If you need more than 100 prints, you can purchase an annual license that allows for a higher number of image exports and prints. Contact Mapbox sales for more information.
If you do not want to purchase an annual license that provides more than 100 high resolution image exports, you can use the Mapbox Static Images API playground. With the Mapbox Static Images API, image exports can be up to 1,280 px by 1,280 px in size. While enabling retina may improve the quality of the image, you cannot export at a higher resolution using the Static Images API.
Settings
The Settings menu includes a lot of options including:
- Debug Tools for debugging your style.
- Supported Mapbox SDK versions for checking compatibility with Mapbox GL JS and our mobile Maps SDKs.
- Default map position for setting and locking map position.
- Compare styles for comparing this style to other styles in your account.
- A Layer overview covering all layers and source layers used in this style.
- The ability to toggle Source compositing on and off.
Debug tools
Debug tools help to visualize behavior that is otherwise invisible to the rendered style. They have no effect on the published style.
- Satellite imagery compares your style against satellite imagery. This is useful for checking the accuracy of map features.
- Raster tiles views raster tiles of your style. Note that style updates may be delayed in the raster tiles.
- Tile boundaries renders outlines to show tile boundaries. Occasionally features will be affected by crossing tile boundaries. Toggling visibility of tile boundaries is useful for debugging clipped or missing symbols.
- Collision boxes renders collision boxes for symbols. This is also useful for debugging clipped or missing symbols.
- Overdraw inspector displays how many times each pixel is being shaded. This is useful for optimizing hardware where pixel processing presents a bottleneck.
- Color blindness simulator lets you simulate different types of color blindness to make sure your map is legible for all viewers.
- Language preview render your style in different languages. This is useful for simulating end-user device language settings.
- Worldview preview render your style with a different worldview. Once published, worldview is determined by the style's Tileset specification.
Supported Mapbox SDK versions
Make sure that all features you are using are supported with specific versions of Mapbox SDKs and view warnings related to compatibility.
Default map position
Set the zoom, bearing (rotation), pitch, and latitude and longitude coordinates for the current map view. You can also toggle Lock default position so that the map returns to the current position whenever the style is opened.
To experiment with camera pitch, bearing, tilt, and zoom and get values to use in your code, try our Location Helper tool.
Compare styles
Compare your working style with another style from your account. Select the style to compare, then click Compare to open a dialog box. Use the swipe arrows to compare maps. Hit Escape or click away from the Compare tool to dismiss the window.
Layer overview
The Layer overview section shows a list of tilesets used in style layers that rely on the tileset. Tilesets are sources. Sources include vector or raster data files uploaded to your account. Your account also includes access to Mapbox tilesets.
There is a limit of 15 unique sources permitted in styles made with the style editor. You can check the number of sources used in Settings Layer overview popover.
Source compositing does not reduce the number of sources counted toward this limit. For example, if you are using a style that references two tileset sources and you add one custom tileset, even if the tilesets are bundled into one composite source, the total number of tileset sources used would be 3. In this example, you could add an additional 12 sources before hitting the 15 source limit.
For more information on source limits, see our Source limits in the Mapbox Studio styles troubleshooting guide.
Source compositing
Any sources in the Mapbox Studio style are composited, or combined, by default. When source compositing is enabled, any Mapbox vector tilesets used and any custom vector tilesets added to your style in the future will be bundled into one composite source. Compositing improves label placement calculations across tilesets and makes maps load faster.
Source compositing can be turned on or off in the Settings section of the toolbar. When source compositing is turned off, you cannot make label placement calculations between layers from different sources.
When you turn source compositing off, this only prevents new sources that you add to the style after clicking the toggle button from being composited. While sources that you add after turning compositing off are added as distinct sources, the existing sources in your style are still composited. If you want a style with no source compositing, you must begin with the Start from scratch option and turn off source compositing before you add any layers.
According to the Mapbox Vector Tile Specification, no two vector layers in a vector tileset may have the same ID. If you try to composite sources with the same ID, a modal will be displayed in the style editor to walk you through resolving the name conflicts.
There is a limit of 15 unique sources permitted in styles made with the style editor. Source compositing does not reduce the number of sources counted toward this limit. For example, if you are using a style that references two tileset sources and you add two custom tilesets, even if the tilesets are bundled into one composite source, the total number of tileset sources would be 4. In this example, you could add an additional 11 sources before hitting the 15 source limit. For more information on source limits see our Source limits in the Mapbox Studio styles troubleshooting guide.
History
See a complete history of changes made in the current session (since opening the style editor). Read more on this functionality in our blog post, Visual undo & redo in Mapbox Studio.
3D properties
Access 3D styling features from the Global tab to improve sense of depth and realism.
Projection
You can specify a style's projection property, which sets the default projection a map is rendered in.
Light
You can specify the anchor, color, intensity, and position of a style's light property, which impacts the appearance of fill extrusion layers. Light attributes can also be adjusted by zoom level.
Terrain
Enable 3D terrain in any map style. After enabling terrain, adjust Exaggeration to multiply all elevation height calculations by a modifier.
Fog
Enable fog in any map style to fade out distant objects. After enabling fog, adjust Range to set the depth of the fog field, Horizon blend to control the blending between fog and sky, or Color to style the color of the fog.
Images
Add and remove images from your style's sprite in this popover. To display images on your map, select in the layer panel on the left.
Fonts
Add and view fonts associated with your Mapbox account (across all styles). Browse Mapbox fonts or upload custom TTF or OTF fonts.
Help
Open Help for links to our help page and contact page. Turn on Tips to become oriented in the style editor. See a full list map interactions and keyboard shortcuts.
Publish
Once you've finished adding data and styling your map, the next step is to publish your style so that you can add it to a web or mobile application.
The Publish button in the upper right allows you to save your style so you can use it in production applications. Every change you make is tracked within Mapbox Studio, and saved as a draft version of your style. The changes will not show in any of your production applications until you click Publish.
Updates can take up to 15 minutes to show on your live map.
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 intended for prototyping and iteration — they are not cached and are heavily rate-limited. If you use a draft style URL in a production application, it could cause degraded performance and blank maps for your end users due to rate limiting. Do not use draft style URLs in production.
Share 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.
Share URL
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 share 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.
Develop
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.
Style URL
A complete style URL, for example mapbox://styles/mapbox/standard, contains three parts:
mapbox://styles- points to Mapbox's Styles APImapbox- the Mapbox username of the style ownerstandard- 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/examples/ck3z58tz90gqf1bs6e4xnzrz4/draft
The mapbox://styles notation for Mapbox styles is an alias to the full
Styles API URL: https://api.mapbox.com/styles/v1/standard.
Access token
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 the Access Tokens page of your Developer Console.
Platforms
Toggle to the platform that is relevant to your project for related resources.
Web
The Web option provides the resources necessary to initialize your map style on a webpage using Mapbox GL JS.
Mapbox GL JS is a JavaScript library for creating interactive maps with Mapbox styles. This API harnesses the power of GL-driven maps, including smooth zooming, map bearing and pitch, and vector data available for interaction and styling in the browser. You can use custom styles created in the Mapbox Studio style editor, or the default styles we provide, and programmatically add additional data including GeoJSON, images, or even video!
For information on using a Mapbox Studio style with Leaflet, see the Leaflet example.
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. You must set it 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.
Third party
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.
Your 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:
https://api.mapbox.com/styles/v1/YOUR_MAPBOX_USERNAME/YOUR_STYLE_ID/wmts?access_token=YOUR_MAPBOX_ACCESS_TOKEN
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
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.