Add layers to maps (Map Viewer)

Note:

Some functionality is not yet supported in the new Map Viewer (formerly known as Map Viewer Beta). See the compatibility guide for more information, and use Map Viewer Classic (formerly known as Map Viewer) as needed for unsupported workflows.

Layers are the contents of a map. They include a wide range of information about people, the earth, life, and so on, and are composed of imagery, tiles, features, and more. To add layers to a map, sign in to your organization and open Map Viewer. You can search for public layers in ArcGIS Online, layers in your content or organization, and subscription layers from ArcGIS Marketplace. You can also add layers from a URL.

When you save a map, the layers you added are saved with it, and the map appears on the My Content tab of the Content page.

Browse layers

To add information to the map, search for layers from your content, your favorites, groups to which you belong, your organization, subscription content, ArcGIS Living Atlas of the World, or ArcGIS Online as follows:

  • My Content—Layers you own.
  • My Favorites—Layers you've marked as favorites.
  • My Groups—Layers from groups to which you belong.
  • My Organization—Layers from your organization.
  • Subscription Content—Ready-to-use map layers and services that have been purchased for your organization from ArcGIS Marketplace.
  • Living Atlas—Selected layers from ArcGIS Living Atlas of the World, including traffic, demographics, and land-cover layers.

    Most ArcGIS Living Atlas layers are free to use in maps and can be viewed by anyone. Some layers contain subscriber content or premium content, which means they consume credits (these are identified in the item description) and can't be viewed by the public. However, if the map contains one or more of these layers and you want to share the map with the public, you can create a map-based app and configure it to allow access to the content through your organizational subscription. (Your subscription will incur any credit costs.)

  • ArcGIS Online—Layers you've added, layers from groups to which you belong, and public layers.
Note:

You will only see some of these options if you are not signed in or if you are signed in with a public account.

When searching for layers to add to the map, you can change the way the results are displayed, sort and filter the results to help you find the layers you need, and add results to your favorites list. You can also view details about each layer to learn more about it before adding it to the map.

Supported layers

You can search for and add the following layers to a map in Map Viewer:

  • Layers you own or that have been shared with you
  • Layers from ArcGIS Living Atlas of the World
  • Marketplace subscription layers
  • Public layers on ArcGIS Online
  • Table layers
  • Sketch layers

You can also add some types of layers using a URL.

Find and add layers

To find and add layers in Map Viewer, complete the following steps:

  1. On the Contents (dark) toolbar, do one of the following:
    • Click Add Add and click Browse layers Browse layers to search for spatial layers.
    • Click Tables Tables and click Add table to search for table layers.

      The Add table pane is prefiltered to show only table layers.

  2. Choose where you want to search for layers: My Content, My Favorites, My Groups, My Organization, Subscription Content, Living Atlas, or ArcGIS Online.

    If you are not signed in, only the ArcGIS Online and Living Atlas options are available. If you are signed in with a public account, all options are available except My Organization.

  3. Optionally, do any of the following to help you find layers:
    • Type search terms in the search box. You can also use advanced search to help narrow the search results.
    • Display layer results in different ways using the view buttons (Table Table and List List).
    • Click Sort Sort to sort the layer results and change the sort direction.
    • Click Filter Filter to narrow the search results. For example, if you are searching for layers in an organization and content categories have been set up, you can use the Categories filter to narrow the results. You can also filter ArcGIS Living Atlas layer results using the ArcGIS standard category set or the Region filter. Use the Status filter to only return layers that have been marked as authoritative. The filter options available depend on where you are searching for layers, and whether and how you are signed in.
      Note:

      To limit search results based on the current map extent, turn on the Only show content within map area toggle button. For example, if the map is zoomed to Nevada, USA, the search results are ordered and based on the map extent. Changing the map extent to Pennsylvania typically returns different results (depending on your keywords). All layers that overlap the current map extent (and match your keywords) are returned.

    • Click the title of a layer to see its details. In the layer details pane, click View full item details Share map to open the item page to see more information about the layer.
  4. Click Add Add on the layer result to add the layer to the map.
  5. Repeat the previous step for each layer you want to add.
    Tip:

    To add any of the layer results to your favorites, click Add to Favorites under the layer thumbnail in the layer details pane. To view your complete list of favorites, choose My Favorites when searching for layers in Map Viewer or on the My Favorites tab on the Content page.

    Once you add layers to Map Viewer Classic, you can configure each layer. For example, you can change the style, create labels, and configure pop-ups on each layer you added to the map.

  6. Click Remove Remove on the layer in the search result list to remove the layer from the map.
  7. Click Back to close the search pane.

Add layers from a URL

You can add the following types of layers using a URL:

CSV

CSV is a web-based, comma-separated values text file that typically includes location information.

Do the following to add a CSV layer:

  1. On the Contents (dark) toolbar, click Add Add.
  2. Click CSV CSV.
  3. Copy the layer's URL into the URL text box.
  4. Click Add to map.

    The data is added to the map and now appears in the Layers pane Layers.

KML

KML is an XML-based file format used to represent geographic features.

Do the following to add a KML layer:

  1. On the Contents (dark) toolbar, click Add Add.
  2. Click KML KML.
  3. Copy the layer's URL into the URL text box.
  4. Click Add to map.

    The data is added to the map and now appears in the Layers pane Layers.

ArcGIS Server web service

An ArcGIS Server web service is a map, image, or feature resource that is located on an ArcGIS Server site.

Do the following to add an ArcGIS Server web service:

  1. On the Contents (dark) toolbar, click Add Add.
  2. Click Web service Web service.
  3. Copy the layer's URL into the URL text box.

    Use the following URL format if you have ArcGIS Web Adaptor configured: https://webadaptorhost.domain.com/webadaptorname/rest/services/folder/service/servicetype. If the service is in the root folder, you do not need to include the folder name in the URL. The URL format in that case is https://webadaptorhost.domain.com/webadaptorname/rest/services/service/servicetype.

    For example, to connect to an ArcGIS Server map service, enter a URL similar to the following: https://webadaptorhost/webadaptorname/rest/services/service/MapServer. For more information and examples, see Components of ArcGIS URLs.

  4. Do the following to append custom parameters to requests made to the service:
    1. Under Custom parameters, click Add parameter.
    2. Type the name of the parameter you want to append in the Parameter text box.
    3. Type the parameter value in the Value text box.
    4. Click Add.

    The specified custom parameters are automatically applied to all requests made to the service.

  5. Do one of the following:
    • Click Add to map to add the data as an operational layer.
    • Click Use as basemap to use the data as a basemap layer.

    The data is added to the map and now appears in the Layers pane Layers or the Basemap pane Basemap.

GeoRSS

GeoRSS is a live web feed that includes geographic features and locations.

Do the following to add a GeoRSS layer:

  1. On the Contents (dark) toolbar, click Add Add.
  2. Click GeoRSS GeoRSS.
  3. Copy the layer's URL into the URL text box.
  4. Click Add to map.

    The data is added to the map and now appears in the Layers pane Layers.

Tile layer

A tile layer is a set of web-accessible tiles that reside on a server.

Do the following to add a tile layer:

  1. On the Contents (dark) toolbar, click Add Add.
  2. Click Tile layer Tile layer.
  3. Copy the layer's URL into the URL text box.

    Enter a URL that contains the level, column, and row placeholders in the following format: https:// ... /{level}/{col}/{row}.png or https:// ... / {z}/{x}/{y}.png. The URL can also contain a placeholder for the subdomains where the map tiles are stored. You can get this URL from the data provider.

    For example, the URL for the OpenCycleMap tile layer contains parameterized values in braces {}: https://www.opencyclemap.org/:https://{subdomain}.tile.opencyclemap.org/cycle/{level}/{col}/{row}.png.

    Note:

    Tile layers added from the web must use the Web Mercator (Auxiliary Sphere) coordinate system to ensure proper display in Map Viewer.

  4. In the Title text box, type a title for the layer.

    The specified title will be displayed in the Layers pane (or the Basemap pane if you add it as a basemap).

  5. In the Attribution text box, enter any copyright information or required attribution information for the tile layer provider.

    The attribution information will be displayed at the bottom of the map.

  6. If the tile layer contains one or more subdomains, use a comma-separated list to specify the tile layer's subdomain labels in the Subdomains text box.

    Subdomains are used by the tile layer provider to distribute tile requests across multiple servers. Not all tile layers have subdomains. If the tile layer does not have subdomains, the Add tile layer window does not display the subdomain field. If you are unsure of the subdomain labels, contact the tile layer provider.

    If the tiles are distributed across multiple servers, you must provide subdomain information.

  7. Optionally, check the Set tile extent to the current extent of the map check box.

    When you check this option, Map Viewer sets the tile extent to include only those tiles visible in the map at the time that you enable the option. Map Viewer will only display tiles in that extent. However, because the tiles are not clipped to fit the extent, tiles may extend beyond the extent.

  8. Do one of the following:
    • Click Add to map to add the data as an operational layer.
    • Click Use as basemap to use the data as a basemap layer.

    The data is added to the map and now appears in the Layers pane Layers or the Basemap pane Basemap.

OGC API - Features

OGC API - Features is a feature service that follows the OGC API - Features specification.

Do the following to add an OGC API - Features layer:

  1. On the Contents (dark) toolbar, click Add Add.
  2. Click OGC API - Features OGC API - Features.
    Note:

    The layer must contain a spatial field.

  3. Copy the layer's URL into the URL text box.
  4. Click the Layers drop-down arrow and choose a layer to add.

    You can only select one layer.

  5. Optionally append custom parameters to requests made to the service, as follows:
    1. Click Custom parameters and click Add parameter.
    2. Type the name of the parameter you want to append in the Parameter text box.
    3. Type the parameter value in the Value text box.
    4. Click Add.
    5. Repeat these steps for each parameter you want to append.

    The specified custom parameters will be automatically applied to all requests made to the service.

  6. Click Add to map.

    The data is added to the map and now appears in the Layers pane Layers.

OGC WFS web service

OGC WFS is a feature service that follows the OGC Web Feature Service specification.

Do the following to add an OGC WFS web service layer:

Note:

You can only add WFS 2.0 layers that support GeoJSON output.

  1. On the Contents (dark) toolbar, click Add Add.
  2. Click OGC WFS web service OGC WFS web service.
  3. Copy the layer's URL into the URL text box.
  4. Click the Layers drop-down arrow and choose a layer to add.

    You can only select one layer.

  5. Optionally append custom parameters to requests made to the service, as follows:
    1. Click Custom parameters and click Add parameter.
    2. Type the name of the parameter you want to append in the Parameter text box.
    3. Type the parameter value in the Value text box.
    4. Click Add.
    5. Repeat these steps for each parameter you want to append.

    The specified custom parameters will be automatically applied to all requests made to the service.

  6. Click Add to map.

    The data is added to the map and now appears in the Layers pane Layers.

OGC WMS web service

OGC WMS is a map that follows the OGC Web Map Service specification.

Do the following to add an OGC WMS web service layer:

  1. On the Contents (dark) toolbar, click Add Add.
  2. Click OGC WMS web service OGC WMS web service.
  3. Copy the layer's URL into the URL text box.
  4. Optionally, choose specific layers in the OGC WMS service to add to the map.

    Skip this step if you want to add the entire service.

  5. Optionally, append custom parameters to requests made to the service, as follows:
    1. Click Custom parameters and click Add parameter.
    2. Type the name of the parameter you want to append in the Parameter text box.
    3. Type the parameter value in the Value text box.
    4. Optionally, check the Append only to requests that draw or query layers check box.

      If you leave the check box unchecked, the parameter is appended to all requests made to the service.

    5. Click Add.
    6. Repeat these steps for each parameter you want to append.

      If you specified custom parameters, they are applied to all the layers you chose. To append different custom parameters to specific layers only, you must add those layers separately.

  6. Do one of the following:
    • Click Add to map to add the data as an operational layer.
    • Click Use as basemap to use the data as a basemap layer.

    The data is added to the map and now appears in the Layers pane Layers or the Basemap pane Basemap.

OGC WMTS web service

OGC WMTS is a set of cached image tiles that follows the OGC Web Map Tile Service specification.

Do the following to add an OGC WMTS web service layer:

  1. On the Contents (dark) toolbar, click Add Add.
  2. Click OGC WMTS web service OGC WMTS web service.
  3. Copy the layer's URL into the URL text box.
  4. Optionally, append custom parameters to requests made to the service, as follows:
    1. Click Custom parameters and click Add parameter.
    2. Type the name of the parameter you want to append in the Parameter text box.
    3. Type the parameter value in the Value text box.
    4. Optionally, check the Append only to requests that draw or query layers check box.

      If you leave the check box unchecked, the parameter is appended to all requests made to the service.

    5. Click Add.
    6. Repeat these steps for each parameter you want to append.
  5. Do one of the following:
    • Click Add to map to add the data as an operational layer.
    • Click Use as basemap to use the data as a basemap layer.

    The data is added to the map and now appears in the Layers pane Layers or the Basemap pane Basemap.

  6. Repeat these steps if you want to add additional layers in your WMTS.