Configure a vector tile layer

Before you share a vector tile layer, you can configure it to specify the tiling scheme, the levels of detail to cache, the tiling format, and other properties. This workflow explains how to modify the default configuration of a vector tile layer. To begin the sharing process, set general properties, and finish sharing, see Share a vector tile layer.

  1. If necessary, open the Share As Web Layer pane and confirm that the Layer Type is Vector Tile.
  2. Click the Configuration tab. If your active portal is ArcGIS Enterprise, click Configure Web Layer Properties Configure Web Layer Properties to access the configurable properties.

    If your active portal is ArcGIS Online, the configurable properties display immediately.

  3. Click the Tiling Scheme drop-down arrow and choose a tiling scheme for your cache.

    The tiling scheme determines the number of levels of detail, the tile dimensions, and the tile origin of the cache. These settings in turn define tile boundaries and must be the same for different web layers used in a web map. The available tiling schemes are described in the following table:



    ArcGIS Online/Bing Maps/Google Maps

    This is the default tiling scheme. The web layer is projected to the WGS 1984 Web Mercator (Auxiliary Sphere) coordinate system. The default tile width and height is 512 by 512 pixels. Scale levels for caching range from zero to 23.

    This is the only tiling scheme available when you share to Portal for ArcGIS 10.4 or 10.4.1.

    WGS 1984 Geographic Coordinate System, Version 2

    The web layer is projected to the WGS 1984 Geographic Coordinate System. The default tile width and height is 512 by 512 pixels. Scale levels for caching range from zero to 22.

    Existing vector tile layer

    The tiling scheme of an existing vector tile layer is used. Browse to a location in your portal and select a vector tile layer. The tiling scheme XML file associated with the layer is downloaded to C:\Users\<user profile>\My Documents\ArcGIS\TilingSchemes\Downloaded.

    Tiling scheme file

    A tiling scheme that you create is used. You can create a tiling scheme XML file with the Generate Map Server Cache Tiling Scheme geoprocessing tool. Additional tiling scheme files can be imported from C:\Program Files\ArcGIS\Pro\Resources\TilingSchemes. Only tiling schemes with scales that double in progression through levels of detail and have 512 by 512 pixel size are supported. The scale defined at level of detail zero must cover the extent of your data.


    A tiling scheme is suggested based on the coordinate system of your map. The levels of detail defined in this tiling scheme are valid for a global extent, so any web layers cached using this tiling scheme can be displayed together. Although the tiling scheme is valid for a global extent, only the extent defined in the map properties is cached.

  4. Under Levels of Detail, use the sliders to set the map scales for which tiles are generated.

    A default scale range is provided. Depending on the purpose of your map and the estimated cache size, you may choose not to cache some very large or small scales.

  5. Under Options, optionally change the Temp local cache location if the default staging location does not have enough disk space.
  6. Choose a Tiling Format.

    Produce tiles based on an index of feature density that optimizes the tile generation and file sizes. This is the default.


    Produce regular tiles for each level of detail without regard to feature density. This cache is larger than that produced with an indexed structure.


    When vector tiles are generated, a contiguous mesh of square tiles is created for each level of detail (LOD) defined by the tiling scheme. The scale of the tiling scheme must double in progression. For example, if the scale is 1:2,000 at LOD1, it must be 1:1,000 at LOD2, 1:500 at LOD3, and so on. When a flat tiling format is used, a complete set of tiles is generated at each LOD without regard to the density of features in any given area. When an indexed format is used, feature density is evaluated to see whether tiles can be reused. For example, an indexed tiling format does not create tiles at high LODs for an area of empty ocean because the area can be represented acceptably by a tile created for a low LOD. This saves tile creation time, storage space, and drawing speed.

    1. Optionally, if you are using an indexed tiling format, select or browse to an Index Polygons dataset.

      If no Index Polygons dataset is specified, index polygons are automatically generated and used for this caching process; however, they are not saved and can't be reused.


      You can create an index polygons dataset with the Create Vector Tile Index tool. This is useful if you anticipate processing the same map more than once. The dataset can be viewed as a map layer so you can see how the feature density of your data is evaluated.

  7. Optionally, check the Allow clients to export cache tiles check box to allow clients to download map tiles for offline use.

    When this option is turned on, you can specify a value in the Limit export to box to limit the number of tiles that can be downloaded in a single request.

Related topics