Add layers from files

You can add layers to Map Viewer by importing data you have stored in supported file formats.

Supported files in Map Viewer and the items created

The following table lists the file types you can add to Map Viewer. For most file types, a hosted feature layer is published and added to the map. For some file types, you must specify whether to publish a layer and use that in the map or add the file directly to the map.

You must be a member of a role that has the privilege to create content. If a hosted feature layer is published, your role must also have the privilege to publish hosted feature layers.

Tip:

For caveats and restrictions related to publishing from each of the file types listed below, see Publish hosted feature layers.

File typeItem or items createdNotes

Comma-separated values (.csv)

When you add a .csv file from a local or network drive, and the file contains location data in longitude and latitude coordinates in decimal degrees, you can add the file or publish the file. If you add only the file, an item is created in My Content for the file and the file is used as a layer in the map. If you publish, an item is created for the file and an item is created for the hosted feature layer (or hosted table layer if you choose to publish a table). The hosted layer is added to the map.

For all other .csv file types and source locations, a hosted feature layer (or table layer if there is no location data in the file) is published and added to the map. An item is created for the file and the hosted layer.

When you add a .csv file containing latitude and longitude data to the map without publishing, updates made to features and attributes in the .csv file automatically appear in the map.

If the file contains location data, the data must use World Geodetic System (WGS84) as its reference coordinate system.

If you publish a file from a cloud drive, the file is not copied and an item is not created for the file in the organization.

File geodatabase

A hosted feature layer is published that contains all feature classes and tables in the file geodatabase. The hosted feature layer is added to the map. An item is created for the file geodatabase and an item is created for the hosted feature layer.

The file geodatabase must be compressed in a .zip file.

If the file is on a cloud drive, the file is not copied and an item is not created for the file in the organization.

GeoJSON

You can add the file or publish the file. If you add only the file, an item is created in My Content for the file and the file is used as a layer in the map. If you publish, an item is created for the file and an item is created for the hosted feature layer. The hosted feature layer is added to the map.

To add a GeoJSON to the map without publishing, the file must be smaller than 50 MB. Any file larger than that must be published.

When you add a GeoJSON file to the map without publishing, updates made to features and attributes in the GeoJSON file automatically appear in the map.

The data must use World Geodetic System (WGS84) as its reference coordinate system.

If you publish a file from a cloud drive, the file is not copied and an item is not created for the file in the organization.

Google Sheet

A hosted feature layer is published. It is added as an item and added to the map.

The Google Sheet is not copied and an item is not created for the file in the organization.

KML

When you add a KML layer, the KML is added to the map and is added as an item. No feature layer is published.

Not supported from a cloud drive.

Microsoft Excel spreadsheet (.xls or .xlsx)

A hosted feature layer is published and added to the map. An item is created for the file and an item is created for the hosted feature layer.

If the Excel file does not contain location data, an item is created for the file and an item is created for the hosted table layer. The hosted table is added to the map.

If the file is on a cloud drive, the file is not copied and an item is not created for the file in the organization.

Open Geospatial Consortium (OGC) GeoPackage

A hosted feature layer is published and added to the map. An item is created for the file and an item is created for the hosted feature layer.

Not supported from a cloud drive.

Service definition (.sd)

A hosted feature layer is published and added to the map. An item is created for the file and an item is created for the hosted feature layer.

Not supported from a cloud drive.

Shapefile (.zip)

A hosted feature layer is published and added to the map. An item is created for the file and an item is created for the hosted feature layer.

If the file is on a cloud drive, the file is not copied and an item is not created for the file in the organization.

Add a file to Map Viewer

To add a file to create a layer in Map Viewer, do the following:

  1. Click Add on the Contents (dark) toolbar and choose Add layer from file.
  2. Choose the location where the file is stored.
    • Your device—Browse to the location of the file on your local machine or a directory on a network share and click Open.

      Tip:
      When adding from a local or network directory, you can drag the file into this window rather than browse to it.

    • Google Drive—Sign in to your Google Drive account and search for or browse to the file.
    • Dropbox—Sign in to your Dropbox account and search for or browse to the file.
    • OneDrive—Sign in to your Microsoft OneDrive account and search for or browse to the file.

    Searching for content in a cloud provider uses the cloud provider's search capability. Searching for content on your device or network uses the search available for the operating system.

  3. If you add a .csv file containing latitude and longitude coordinate locations, or you add a GeoJSON file, choose one of the following options:
    • Create a hosted feature layer and add it to the map—A hosted feature layer is published for a .csv file containing coordinate locations or a GeoJSON file and the hosted layer is added to the map. A table layer is published for a .csv file with no location data and the table layer is added to the map.
    • Upload the file as an item and add it to the map—The .csv or GeoJSON file is added to the map.
  4. If you add a .zip file, choose the content type from the Item type drop-down menu.
  5. If you add an Excel file that contains more than one sheet, choose which sheet to use.
  6. If you add a .csv or Excel file, define the fields to include and choose the type of location data, if any, to use for the layer.
    1. If you are publishing from the file, choose which fields to include.
    2. Optionally, provide display names and data types for the fields.
    3. Optionally, if you are publishing from the file and the file contains date fields that store dates in a time zone other than UTC, define the time zone.

      The time zone you specify is used for all date fields stored in the hosted layer that is published from the file.

    4. Click Next.
    5. If the file includes location information, choose the type of location information that Map Viewer uses to locate features and choose the locator to use to geocode locations.

      By default, Map Viewer geocodes locations based on your organization's region. To change the country that Map Viewer uses to geocode the locations in the file, choose a different country from the Country drop-down menu. If your file contains locations from multiple countries or from a country not in the list, choose World.

    6. If the file does not contain location information or if you do not want to include the location information, choose None to have Map Viewer add the data as a table.

      This option is only available when publishing from the file.

    7. Review the location fields and click a cell to change which location field or fields are used.
  7. Click Next.
  8. Type a title.
  9. Choose a folder in My content where you want to save the item.
  10. If your organization has set up content categories, click Assign categories and select up to 20 categories to help people find the item.

    You can also start typing a category name to narrow the list of categories.

  11. Optionally, type tags that describe the item.

    Separate the terms with commas (for example, Federal land is considered one tag; Federal, land is considered two tags).

    As you type, you can select any of the suggested tags that appear; suggestions are generated from tags you have added previously.

  12. Optionally, provide a summary that describes the item.
  13. Click Create and add to map.

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

If you published a hosted feature layer from a .csv or Excel file containing addresses or place names, you should review feature placement before sharing the layer and map with others.