Add layers to a map or scene

A layer references a dataset that is stored in a geodatabase or a service. The data can be in a local directory, on a network drive, in ArcGIS Online, or on your organization's portal.

When you add data to a map or scene, it is represented as a new layer. You can also add layers to a map by adding an existing layer or an existing layer package. Layers that are provided as a file have an .lyrx extension. Layer files contain all the layer properties and a reference to the dataset. Layer packages have an .lpkx extension. They contain all the layer properties and the dataset together. Layer files and layer packages are added to a map in the same manner. They are both collectively referred to as layers.

Layers in a map reference the source dataset but do not control the data. You can source the same data in many layers simultaneously. If the dataset is moved, deleted, or otherwise unavailable to the layer, the layer cannot connect to the data or draw its features.

You must download online layer files and layer packages to a local directory before you can use them. You must open a layer package before the layer it contains is added to the map. The layer created in the map accesses the data provided with the package. By default, the contents of a package are placed in the <User Documents>\ArcGIS\Packages folder when you open the package. You can change this location on the Share and Download Options dialog box.

Legacy:

If a layer was defined using ArcGIS Desktop, you must import the layer's definition to the ArcGIS AllSource layer format before you can create a layer with that definition. You are notified if a property of the layer cannot be imported successfully or if the data referenced by the layer is not supported in ArcGIS AllSource.

Browse to data to add to a map or scene

You can build maps and scenes from data originating from a variety of locations, both local and online. Browse to the data you want to see in a map. When you add it, a layer referencing that data is created.

Add data from the Add Data dialog box

The most common way to add data to a map or scene is to use the Add Data button. You can add data that is in a local directory, or you can access data online. ArcGIS Online provides many ready-to-use layers. Existing layers may also be available from your organization's portal.

Follow these steps to add a layer or layer package to a map or scene:

1. Make sure a map or scene is your active view.
2. On the Data tab, in the Import group, click Add Data and click Data .
3. On the Add Data dialog box, browse to a layer at an online location or a local location:

   • To add a local layer on your computer or that your organization maintains on a network, on the Add Data dialog box, browse to the local directory. If you use these layers frequently, consider adding a folder connection to this location from the project to ensure that the layers are indexed and to save time browsing to the location.

     Tip:

     You can drag datasets (for example, layer files or packages, shapefiles, images, tables, or TIN, LAS, and KML datasets) from your file system onto a map or scene to create a layer. Drag them into the Contents pane of the map or scene to specify exactly where in the layer draw order you want the new layer to appear.

   • To add an online layer, under Portal, click All Portal in the quick links panel. Type layer in the Search box and press Enter. To find layers defined by Esri, add the search term owner:esri in the Search box along with any other appropriate keywords.

4. Select the layers in the search results that you want to add and click OK.

Add data from the Catalog pane

You can also browse to or search for layers in the Catalog pane and add them directly to a map.

1. In the Catalog pane, browse to or search for the layers in the project or the active portal to add to the map.
2. Right-click a layer or press Ctrl and select the layers to add.
3. Add the selected layers to the map.
   • From the Catalog pane, drag the selected layers onto the active map or to a specific position in the map's Contents pane.
   • From the Catalog pane, right-click the selected layers and click Add To Current Map . This option is not available if the active view is not a map or a scene.
   • From the Catalog pane, right-click the selected layers. The context menu lists options that add the layers to an open map or scene. Click the option to add the layers to a specific map. For example, click Add To World to add the layers to a map named World.
   • From the Catalog pane, right-click the selected layers and click Add To New Map . This option creates a map and immediately adds the layers to it.

Add data from a path

To create a map layer in a map or scene from an existing dataset, you can browse to or search for a dataset or add one directly from a path. You can add file-based data, portal items, and data from an enterprise database directly from a path.

You can add data to a map from a path, such as a file directory or URL. To add a dataset from a path, complete the following steps:

1. On the Data tab, in the Import group, in the Add Data menu , click Data From Path .
2. Type the path or URL to the dataset.

   Providing a path to a table adds a stand-alone table to the project. Providing a path to an enterprise database requires an existing connection file. The following are examples of acceptable path formats:

   • \\mypath\testDB.sde\testDB.gisuser.USA\testDB.gisuser.states

     • The states feature class from the USA feature dataset in an enterprise database is added.

   • http://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Demographics/ESRI_Census_USA/MapServer

     • The ESRI_Census_USA map service layer is added.

   • http://sampleserver6.arcgisonline.com/arcgis/rest/services/NapervilleShelters/FeatureServer/0

     • The Shelters feature layer from the NapervilleShelters feature service is added.

   • https://www.arcgis.com/home/item.html?id=a842e359856a4365b1ddf8cc34fde079

     • The World Boundaries and Places map image layer is added using its item ID.

   • https://a.tile.openstreetmap.org/{level}/{col}/{row}.png
   • https://tile.waymarkedtrails.org/hiking/{z}/{x}/{y}.png

     • A tile layer from the OpenStreetMap or Waymarked Trails tile service is added. If the URL includes a {subdomain}, it must be specified (in this example, the letter a). Consult the service provider's documentation for available subdomains.

   When you add a service layer from a URL, a map service, a WMS service of a map service, a feature service, or an image service, an attempt is made to determine the service type.

3. If you know the service type, choose it from the Service Type drop-down menu.

   When you are working with a service URL that is hosted on a third-party server and the URL is not deterministic, you must specify the service type from the list to add the data.

   If the service type cannot be determined, the service type is listed as Automatic.

4. Click Add to create a layer in the map or scene referencing the data.

Custom request parameters

When you add ArcGIS Server services, vector tile services, or WMS services, you can add custom request parameters. These are key-value pairs that can be appended to the URL for all resources and operations fetched by the service layer. These are often access keys to allow access to restricted data. In some cases, you must specify the access key-value pair to add the data. Contact the administrator of the service for the access keys if you are working with restricted access services.

To append custom request parameters to a URL when you add a service, complete the following steps:

1. Expand the Custom request parameters heading.
2. In the table, add the key or parameter name in the Parameter column of the table and add the corresponding value in the Value column.
3. Add rows to the table if there are additional key-value pairs.

Once a layer has been added to a map or scene, you can manage the layer's custom request parameters from the Custom Parameters tab on the Layer Properties dialog box.

Copy a layer from one map to another

A project can have multiple maps, each of which has its own set of layers. You can copy a layer from one map to another map.

Follow these steps to copy layers between maps in a project:

1. In the Contents pane of the source map or scene, select the layer.
2. Right-click the layer and click Copy .
3. Open the target map.
4. In the Contents pane, right-click the name of the map or scene (by default, it is called Map or Scene, respectively, but may have been renamed) and click Paste .

Tip:

You can also drag a layer file or package from a project in one instance of ArcGIS AllSource to a map or scene in another instance of ArcGIS AllSource.

Create a layer from a template

You can use a layer template to add a new, editable layer to the active map. A layer template is a schema-only layer package; it defines the symbology and other display properties for the layer and the schema for the underlying dataset. When you add new features to the layer, they are stored in the new dataset.

To add a layer from a template to an active map or scene, on the Edit tab, in the Layer group, click one of the layer templates in the gallery.

New datasets are created in the project's default geodatabase as described by the layer template's schema. A new layer is created in the active map as defined by the layer definition. The new layer is connected to the new dataset in the default geodatabase. When you browse or search for layers in a project or online, you may find schema-only layer packages. These packages work in the same manner as layer templates when you add them to a map.