Styles

The Mapbox Studio style editor is a tool for creating map styles. A style is a set of rules for how your map will be drawn on the page. It includes references to your data, map images (icons, markers, patterns), fonts, and, most importantly, it defines how all of your data should be styled on your map.

Mapbox Studio topics covered in this section:

Upload

Dataset

Tileset

Template style

Custom style

Add data to style

Style data

Publish

What is a style?

A style is a JSON document that conforms to the Mapbox Style Specification. The style specification is designed especially for Mapbox GL JS (browser) and the Mapbox mobile SDKs (mobile) to read and understand so your map can be rendered on the page. The style controls almost everything about the map.

Manage styles

From the Styles page you can create, manage, and edit any of your styles and find links for developing with Mapbox template styles.

Create a style

From the styles page, you can create a new style to be edited in the style editor. Creating a style from the Basic template is the best way to get started. Click Create and the Basic style will open in the style editor.

You can also choose More ways to create to:

  • Create a custom style from another template style or designer style.
  • Choose Start blank to start with a blank style.
  • Upload your own style JSON according to the Mapbox Style Specification.
help
Note

If you have previously downloaded a Mapbox Studio style, you can upload it to the Mapbox Studio style editor 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 Mapbox Studio styles troubleshooting guide.

Search styles

Use the Search styles 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 or date modified.

Share & use a style

You can add your style to a web or mobile application. See the Publish style section of this manual for more information and instructions.

Click on the menu next to each style to uncover 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.

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.

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. However, 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 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.

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.

Style editor

The Mapbox Studio style editor allows you to create a custom style by adding and editing layers, uploading custom icons, and publishing your style. Click on the name of any style listed on your Styles page to open it in the style editor.

Layers list

Style a layer & Select data

Map canvas

Toolbar

Publish style

The Publish style button in the upper right of the style editor allows you to save your style so you can share it and use it in other applications. Every change you make is tracked within Mapbox Studio, but the changes will not show in any of your applications or on the share page until you click Publish style. Updates can take anywhere from 5 to 10 minutes to show on your live map. For more information, see Share & use a style.

Click the printer icon 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.

The number of print exports permitted for your account is based on plan level:

Plan levelAvailable image exports per account (total)
Pay-as-you-go5
Commercial50
EnterpriseContact sales

If you need more image exports and prints, but are not interested in an Enterprise plan, check out the Mapbox Static API playground. With the Mapbox Static 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 API.

Be sure to read the Mapbox print policy before printing any Mapbox maps.

screenshot of the print panel with print export settings as described above

Layers list

A layer is a styled representation of data or the canvas of your map. Layers power your map's visualization. Without layers, your data will not be shown. You can create multiple layers from the same data and you can filter data by attributes for styling in a layer. You can also fill the canvas with a color or pattern which will apply across the whole world.

The Layers list is always available and visible along the left side of the style editor window. There are several tools for managing layers at the top of the list, including:

  • Duplicate a layer to create a copy of an existing layer.
  • Group and Ungroup layers to style them individually and sort them.
  • Hide and Show layers.
  • Delete layer to permanently remove a layer. You can undo this using CTRL + Z in 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

In the style editor, you can add custom data as new layers. To create a new layer, click + Add layer at the top of the layers panel. There are two options when adding a new layer to your style: Data sources and Background layer.

Data sources

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. See the Geospatial data section for more information on adding custom data.

Each layer needs data to work with, otherwise the style rules would not be applied to anything. (The exception is a background layer — see the next section for more details). To specify data for the layer, choose a Data source from the list of available tilesets used currently 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, or upload a new tileset with the + Upload button.

select data panel after clicking add layer

help
Source limit

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 Mapbox Studio styles troubleshooting guide.

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 show all or select geometry types in your tileset by Polygon, LineString, and Point.
  • Zoom extent: sets the min (start) zoom and max (last) zoom to which you data is viewed on the map (learn more about manually adjusting zoom extents in here).

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.

animated gif walking through how to filter a source layer by adding a vector source clicking Filter > Add filter > Select an "Available field" > Click Empty > Select a value

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.

RBG-encoded DEM sources: If you select an RBG-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.

Background layer

A background layer is a style layer without an associated tileset. Background layers cover the full extent of your map canvas. You can create as many background layers as you want. Using multiple background layers is a great way to create textures for your map styles.

To create a background layer, click + Add layer at the top of the layers panel, choose the Background layer tab and click the Create background layer button.

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:

  1. Click Images in the toolbar on the right side of the style editor.
  2. Click Upload SVG image.

The image will then be uploaded to your style and available for use on any layer.

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.

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, however 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.

screenshot showing an example of a fill layer

To add a pattern to a fill layer in the Mapbox Studio style editor:

  1. Click Images in the toolbar on the right side of the style editor.
  2. Click Upload SVG image.
  3. Select the desired fill layer from the layers panel on the left side of the style editor.
  4. Click the Pattern field.
  5. Click to select the desired image.

Fill-extrusion

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. Use the Light panel with fill extrusion layers to control the color, direction, and intensity of the lighting source.

screenshot of a fill extrusion layer displaying 3D buildings in the Mapbox Studio style editor

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. Take a look at the map style templates Mapbox Streets or Mapbox Outdoors for examples of detailed line styling with the roads, tunnels, and bridges data layers.

To add a pattern to a line layer in the Mapbox Studio style editor:

  1. Click Images in the toolbar on the right side of the style editor.
  2. Click Upload SVG image.
  3. Select the desired line layer from the layers panel on the left side of the style editor.
  4. Click the Pattern field.
  5. 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. Circle layers are good for representing scaled or interactive data, and they are best used 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 is perfect for showing 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 very 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: Fonts can only be set 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 template style, map labels will appear in English by default. You can change the language of your map's labels directly in the Mapbox Studio style editor. All Mapbox template maps 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:

  1. Create a new style or edit an existing one in Mapbox Studio.
  2. Select the layer that contains the labels you'd like to edit.
  3. Under the Text tab, click the current value in the Text field. A panel will appear with all language options for the layer.
  4. Click the desired language; the map will update on select.
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 the Mapbox Studio style editor:

  1. Click Images in the toolbar on the right side of the style editor.
  2. Click Upload SVG image.
  3. Select the desired symbol layer from the layers panel on the left side of the style editor.
  4. From the Style tab select the Icon tab.
  5. Click the Image field.
  6. 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 amongst 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 miniumum 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, check out 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.

screenshot of a heatmap layer displaying POI density in the Mapbox Studio style editor

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 RGB. When selected, it uses the hillshade layer type to provide a number of properties to style it.

animated gif illustrating the process outlined above for adding a hillshade layer

Background layer

Properties for background layers include:

For more information on background layers, see the Background layer section above.

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.

hover to see property 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 property

Read more about how to use each of these options for specifying property values below.

Set value

Click on each property to edit the value directly.

animated gif of a tileset in the Mapbox Studio style editor

Style across zoom range

Style properties can be chosen 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:

animated gif showing an example using zoom functions in the Mapbox Studio style editor
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.

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 similar to CSS transition properties like 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.

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.

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 similar to CSS transition properties like 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:

screenshot of the popover for editing style property values using a property function in the Mapbox Studio style editor

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.

For example, in the Mapbox Basic 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).

screenshot of the landuse layer in the Mapbox Basic style using conditional logic to style parks, hospitals, and schools differently

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.

screenshot 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 easily match the current layer to other layers in the style.

Edit property as JSON

The Mapbox Studio style editor allows you to edit a style property's JSON directly. The style property 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.

animated gif showing how to find the style JSON editor at the bottom of the panel for each style property

help
Note

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. It can be found 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.

help
Layer from data

These are the same options that are available when adding a new layer from data to your style.

Read more about the available fields in the Select data panel below.

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 (see Filter section below) 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

Geometry type: To filter by geometry type, click to remove the geometries you want to be excluded. All are included by default.

Field value: When you filter by field value, 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:

  1. Click + Add filter to bring up a list of fields in your tileset.
  2. Select the field to filter on.
  3. Select 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).
  4. Click the box below the filter creation options to define the value of the field to filter on. 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.
  5. Click + Add value to add an additional filter based on the field value.

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, check out our troubleshooting guide.

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 layers at a single point and when the Select data panel is open, you can inspect individual features from the selected tileset to view their properties.

Toolbar

The toolbar is always in the upper right of the screen in Mapbox Studio style editor.

Search places

The Search places bar allows you to search for locations on the map. Type in what you're looking for, and select to be taken to that exact location. This search is powered by the Mapbox Geocoding API.

Although you can search and view places in the style editor, you cannot create new points in the style editor. See the next section on the Mapbox Studio dataset editor to learn how to search for places and create new features to be added to your map.

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. The default position that has been specified is shown below the toggle button.

Debug

Satellite imagery

Toggle Satellite imagery to compare your style to satellite imagery. This is useful for checking the accuracy of map features.

toggle satellite imagery

Raster tiles

View raster tiles for your style. Note that style updates may be delayed in the raster tiles.

Tile boundaries

Toggle Tile boundaries to see tile boundaries. Occasionally features will be affected by crossing tile boundaries. Toggling visibility of tile boundaries is useful for debugging clipped or missing symbols.

tile boundaries

Collision boxes

Toggle Collision boxes to see collision boxes for symbols. This is also useful for debugging clipped or missing symbols.

collision boxes

Overdraw inspector

overdraw inspector

Compare styles

Compare your working style with another style from your account. Select the Style to compare, click Compare to open a dialog box and use the swipe arrows to compare maps. Hit Escape or click away from the Compare tool to dismiss the window.

compare styles swipe

Source compositing

Any sources in your 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 composting can be turned on or off in the Debug section of the toolbar. When source compositing is turned off, label placement calculations can not be made between layers from different sources.

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.

help
Source limit

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 template style that references both the Mapbox Streets and Terrain tilesets (in other words, 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 Mapbox Studio styles troubleshooting guide.

Style reference

The Style reference contains two sections: a list of all sources used and reference groups.

List of sources

The Style reference shows a list of tilesets that are used in the style and a list of 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 the Style reference popover.

Source compositing does not reduce the number of sources counted toward this limit. For example, if you are using a template style that references both the Mapbox Streets and Terrain tilesets (in other words, 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.

screenshot of the source list section of the style reference popover

For more information on source limits, see our Source limits in Mapbox Studio styles troubleshooting guide.

Reference groups

The underlying GL renderer uses reference groups to render similar layers faster. Layers with matching define properties (type, source, source layers, zoom, and filter) and style layout properties are automatically grouped. Knowing how your layers are grouped helps you optimize your style.

Compatibility

Ensure that all features you are using are supported with specific versions of Mapbox SDKs and view warnings related to compatibility.

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.

Light

When using a fill extrusion layer, you can specify the anchor, color, and intensity of lighting. Each can also be adjusted by zoom level.

Fonts

Add and remove all fonts associated with your Mapbox account (across all styles). Browse Mapbox fonts or upload custom TTF or OTF fonts.

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.

screenshot of the Manage style images popover

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.

Full screen

Use Mapbox Studio in full screen mode.

Reset pitch

Reset pitch to zero to look at the map straight on.

Reset north

Reset the rotation of the map so north is up.

Zoom

Zoom in or out from the current map view.

Classic styles

You can find your Mapbox Studio Classic styles and Mapbox Editor projects on the Mapbox Classic page.

Classic styles

Click Upload Classic style to upload a style from Mapbox Studio Classic in tm2z format to your account.

Each listed style shows the date the style was added, the size of the style, and the style ID. For each style, you can:

  • view statistics for the style
  • replace the style
  • delete the style
  • open the style in a new window and share it

Classic projects

Note: Mapbox Editor, the tool used for creating and editing Classic projects, has been deprecated. Your existing projects can be found on the Classic page in Mapbox Studio. For more information, see our announcement and guide to migrating a Mapbox Editor project.

This section lists projects created in the legacy Mapbox Editor. Each project listed shows the date added, the number of classic style layers in the project, and the project ID. For each style, you can:

  • delete the project
  • share the project with a Share URL
  • GeoJSON download data as GeoJSON
  • KML download data as KML
Next page:
Tilesets
Learn how to create and manage tilesets in Mapbox Studio.