Adding tile layers to your web map

With the March 2013 ArcGIS Online update, map authors can now add GeoRSS, OGC WMTS, and tile layers to their web maps. Here’s how you add tile layers using the map viewer.

About tile layers

A tile layer is a set of web-accessible tiles that reside on a server. The tiles are accessed by a direct URL request from the web browser. For example, OpenCycleMap is a tile layer. Because the tiles in a tile layer are not available as a service, they must be in a specific format on the web server. Client applications consuming the tiles such as map viewer use the format to request the appropriate tiles.

Access to the appropriate tiles in the tile layer depends on the URL to the tile layer. The URL contains parameterized values, which are used by the map viewer to dynamically request the tiles that correspond with the extent and scale of the web map as you pan and zoom. This is the tile layer URL for

The portions of the URL encapsulated with {} indicate parameterized values, which the map viewer uses to dynamically access specific tiles. Each parameter is detailed below:

{subdomain} Subdomains are used by the tile layer provider to distribute tile requests across multiple servers. For example, the OpenCycleMap tile layer contains three subdomains: a,b,c. Not all tile layers have subdomains. If you are unsure of the subdomain labels, contact the tile layer provider.

{level},{col},{row} These three parameters are used by the map viewer to dynamically access tiles. No input necessary.

How to add a tile layer to your web map

Step 1: Open the map viewer and click Add.

Step 2: Choose Add Layer from Web.

Step 3: Choose A Tile Layer.

Step 4: Enter the layer’s web address in the URL field.

Step 5: If the tile layer contains one or more subdomains, specify the tile layer’s subdomain labels in the Subdomains field. Delimit the labels with commas. If you are unsure of the subdomain labels, contact the tile layer provider. If the tile layer does not have any subdomains, the window does not display the subdomain field.

Step 6: Enter a title for the tile layer in the Title field.  The title is used as the name of the tile layer in the map contents.

Step 7: Enter any copyright information or required attribution information for the tile layer provider in the Credits field. The map viewer displays the information you enter in the lower right of the map.

Step 8: Click the Set Tile Coverage button and set the extent of the tile coverage. Tile coverage represents the extent of all the tiles. This is an optional setting. When the extent is set, tiles are only requested for the extent specified. However, because the tiles are not clipped to fit the extent, tiles may extend beyond the extent.

Step 9: Check the box next to Use as Basemap if you want to use the layer as a basemap.

You now have all the information you need to add your tile layer to your map.

Step 10: Click Add Layer.

The layer is added to your web map.

For more information, see Adding layers from the web.

This entry was posted in ArcGIS Online and tagged , , . Bookmark the permalink.

Leave a Reply


  1. carlynne says:

    This is very helpful, thanks!

    Is there any way to use the tile in ArcGIS Desktop?

  2. says:

    This is proving to be very useful for displaying real-time weather radar in web maps.
    It would be useful to be able to store a tile layer as an item in ArcGIS Online.
    Will this be a new feature sometime soon?

  3. fellsman says:

    Nice, but is it possible to add a tiled basemap using a specific projection e.g.{z}/{x}/{y}.png
    This serves Open Street Map for the UK in the UK national projection (EPSG 27700).
    Thanks, Graham

  4. Chris Whitmore says:

    Hi Graham, unfortunately only Web Mercator is supported at this time — which includes the other tile layer URL in the link you provided (the one using Google Web Mercator).

    Thanks for the feedback,


    • fellsman says:

      Thanks for the update Chris. I am using the javascript API rather than ArcGIS Online and just need to confirm – at the moment it is only possible to use tiled OGC web services as a basemap if they are served in Web Mercator projection?
      If this is the case, are there any plans to enable the use of other projections for basemaps in the near future?
      Thanks Graham

  5. gtm2 says:

    Hi all, I would like to use a Google maps tiled service in ArcGIS online. Does anyone have experience with this layer? I suppose it costs something to use it, right? Any hints on where I could find/purchase the URL? Cheers, Mark

  6. ryanmonk says:

    Is there a way to get Tile Layers to zoom level 19 (scale 1:1,128)?
    The “Set Visibility Range” slider only goes up to “Building (1:1,250)” and the layer disables itself after zooming in past that. Our imagery services go all the way to level 22, but we can’t get them to display using a Tile Layer in ArcGIS Online.