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.

Follow these steps to update the style of a vector tile layer using the Change Style button in Map Viewer.

  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. Create a style 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 layer item that stores the new style is created in your content. This layer item references the data in the hosted vector tile layer; the data is not copied or duplicated.

  6. In the Change Style window, make the style changes you want. For more information, see the ArcGIS Vector Tile Style Editor documentation.
  7. When finished, click Save style and close.

    Your style changes are displayed in the map and automatically saved with your layer. You can use this new layer item whenever you want to apply this style to the vector tile layer.

    Note:

    In some cases, you may need to change a vector tile layer's style manually—for example, if you are using filters or custom fonts. You can manually change a vector tile layer's style 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.