Skip To Content

Update vector tile layer style

If you have privileges to create content, you can customize the style of any vector tile layer, including vector basemaps, in Map Viewer. For example, you might want to change the style of an Esri vector basemap to better suit your organization's brand requirements. You can make changes to the layer's colors, patterns, icons, and labels. If you want to customize a vector tile layer that you don't own, you must first save a copy of the layer as an item and then make style changes to the copied layer.


The following steps show how to update the style of a vector tile layer using the Change Style button in Map Viewer. You can also change a vector tile layer's style manually by saving a copy of the layer, downloading the associated style file (root.json) from the layer's item page, editing the file using a JSON editor, and updating your copy of the vector tile layer with the new style. For information on manually changing the style of vector tile layers, see Mapbox GL Style Reference and Mapbox vector tile specification.

  1. Verify that you are signed in to ArcGIS Online and have privileges to create content.
  2. In Map Viewer, add the vector tile layer that has the style you want to update.
  3. If necessary, click Details and click Content.
  4. Under the layer you added, click Change Style Change style.
  5. If you don't own the vector tile layer, make a copy of the layer as follows:
    1. In the Save style as window, specify a title, tags, summary, and folder location for your new layer.
    2. Click Save Style.

      A vector tile layer item is automatically created in your content.

  6. In the Change Style window, make the style changes you want. For more information, see the Style a vector basemap tutorial.
  7. When finished, click Save style and close.

    Your style changes are displayed in the map and automatically saved with your layer.