Web Tiled Layer (WebTiledLayer)

A tile layer is a derived from a set of web-accessible tiles which reside on a server. The tiles are accessed by a direct URL request from the web browser. Because the tiles in a tile layer are not available as a service, they must be in a specific format for a web app such as the ArcGIS.com map viewer to display the layer on a map.

Referenced by: baseMapLayer, operationalLayers


Property Details
blendMode Blend modes are used to create various effects by blending colors of top and background layers. normal blend mode is the default.
Valid values: average, color, color-burn, color-dodge, darken, destination-atop, destination-in, destination-out, destination-over, difference, exclusion, hard-light, hue, invert, lighten, lighter, luminosity, minus, multiply, normal, overlay, plus, reflect, saturation, screen, soft-light, source-atop, source-in, source-out, vivid-light, xor
copyright Attribution to the Web Tiled Layer provider. It is displayed in the attribution on the web map. Input required by the user when the layer is added to the web map.
effect Effect provides various filter functions to achieve different visual effects similar to how image filters (photo apps) work.
fullExtent An extent object representing the full extent envelope for the layer.
id A unique identifying string for the layer.
isReference This is applicable if used as a baseMapLayer. A boolean value indicating whether or not the baseMapLayer draws on top (true) of other layers, including operationalLayers , or below (false).
itemId Unique string value indicating an item registered in ArcGIS Online or your organization's portal.
layerType String indicating the layer type.
Valid value of this property WebTiledLayer
maxScale A number representing the maximum scale at which the layer will be visible. The number is the scale's denominator.
minScale A number representing the minimum scale at which the layer will be visible. The number is the scale's denominator.
opacity The degree of transparency applied to the layer on the client side, where 0 is full transparency and 1 is no transparency.
refreshInterval Refresh interval of the layer in minutes. Non-zero value indicates automatic layer refresh at the specified interval. Value of 0 indicates auto refresh is not enabled.
subDomains[] If subdomains are detected, they must be specified. The map viewer detects if the Web Tiled Layer has subdomains by parsing the templateURL value for {subDomain}.
templateUrl URL to the Web Tiled Layer. Input required by the user when the layer is added to the web map. The template URL contains a parameterized URL. The URL can contain the following templated parameters: 'level', 'col', 'row', and 'subDomain'.
tileInfo Contains the spatial reference and the tiling scheme of the layer. Typically retrieved from a WMTS OGC Web Service. If missing the layer must be in the WGS 1984 Web Mercator (Auxiliary Sphere) tiling scheme.
title A user-friendly string title for the layer that can be used in a table of contents.
type Deprecated, use layerType instead.
visibility Boolean property determining whether the layer is initially visible in the web map.
visibilityTimeExtent Represents time extent that will control when a layer should be visible based on webmap's current time. Visibility time extent only affects the layer visibility and will not filter the data.
wmtsInfo Object containing information about the chosen WMTS service layer and tiling schema.

Additional information

Live sample web maps showing the WebTiledLayer as an operationalLayer. Live sample web maps showing the WebTiledLayer as a baseMapLayer.

WebTiledLayer as an operationalLayer Example

  "templateUrl": "https://{subDomain}.tile.thunderforest.com/cycle/{level}/{col}/{row}.png",
  "id": "OpenCycleMap",
  "type": "WebTiledLayer",
  "layerType": "WebTiledLayer",
  "blendMode": "color",
  "title": "OpenCycleMap",
  "copyright": "'Maps © <a href='https://www.thunderforest.com'>Thunderforest</a>, Data © <a href='https://www.openstreetmap.org/copyright'>OpenStreetMap contributors</a>'",
  "fullExtent": {
    "xmin": -20037508.342787,
    "ymin": -20037508.34278,
    "xmax": 20037508.34278,
    "ymax": 20037508.342787,
    "spatialReference": {
      "wkid": 102100
  "subDomains": [
  "visibility": true,
  "opacity": 1

WebTiledLayer from a WMTS service Example

  "templateUrl": "http://maps1.wien.gv.at/wmts/lb/farbe/google3857/{level}/{row}/{col}.jpeg",
  "id": "WMTS_659",
  "itemId": "0217f8067457410a998fc9293563ba94",
  "layerType": "WebTiledLayer",
  "title": "Luftbild",
  "copyright": "http://data.wien.gv.at/nutzungsbedingungen",
  "fullExtent": {
    "xmin": 1800036.1661272035,
    "ymin": 6123507.424977349,
    "xmax": 1845677.1573524445,
    "ymax": 6161931.724216427,
    "spatialReference": {
      "wkid": 102100
  "tileInfo": {},
  "wmtsInfo": {
    "url": "http://maps.wien.gv.at/wmts",
    "layerIdentifier": "lb",
    "tileMatrixSet": "google3857"
  "visibility": true,
  "opacity": 1,
  "minScale": 591658710.9094299,
  "maxScale": 1128.499433349543

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.