CSV Layer (CSV)

The CSV layer type references a CSV or TXT file from a publicly-accessible web server. It then dynamically loads into the map at run time. The CSV layer will maintain a reference to the CSV resource.

Referenced by: 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 | | columnDelimiter | A string defining the character used to separate columns in a CSV file.
Valid values:

  • \t (tab)
  • (space)
  • , (comma)
  • ; (semicolon)
  • | (pipe)
| | customParameters | A sequence of custom parameters appended to the URL of all requests related to a layer. | | disablePopup | Indicates whether to allow a client to ignore popups defined by the service item. | | effect | Effect provides various filter functions to achieve different visual effects similar to how image filters (photo apps) work. | | featureEffect | Feature Effect emphasizes or deemphasizes features that satisfy a filter using graphical effects | | id | A unique identifying string for the layer. | | layerDefinition | A layerDefinition object defining the attribute schema and drawing information for the layer. | | layerType | String indicating the layer type.
Valid value of this property CSV | | locationInfo | A locationInfo object defining how location information will be retrieved from a CSV file. | | opacity | The degree of transparency applied to the layer on the client side, where 0 is full transparency and 1 is no transparency. | | popupInfo | A popupInfo object defining the content of popup windows when you click or query a feature. | | 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. | | showLabels | Labels will display if this property is set to true and the layer also has a labelingInfo property associated with it. This property can get stored in the web scene config. | | showLegend | Boolean value indicating whether to display the layer in the legend. Default value is true. | | title | A user-friendly string title for the layer that can be used in a table of contents. | | type | Deprecated, use layerType instead. | | url | The URL to the layer. | | visibility | Boolean property determining whether the layer is initially visible in the web map. |

csv Layer Example

Live sample web map showing the CSV as operationalLayer

  "id": "csv_7927",
  "layerType": "CSV",
  "title": "Earthquakes",
  "visibility": true,
  "opacity": 1,
  "url": "http://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/2.5_month.csv",
  "columnDelimiter": ",",
  "blendMode": "overlay",
  "layerDefinition": {
    "geometryType": "esriGeometryPoint",
    "objectIdField": "__OBJECTID",
    "typeIdField": "",
    "fields": [],
    "types": [],
    "capabilities": "Query",
    "name": "csv",
    "extent": {
      "xmin": -20034970.25849882,
      "ymin": -9494815.985282788,
      "xmax": 20026086.963133518,
      "ymax": 14269743.874052156,
      "spatialReference": {
        "wkid": 102100
  "popupInfo": {},
  "locationInfo": {
    "locationType": "coordinates",
    "latitudeFieldName": "latitude",
    "longitudeFieldName": "longitude"

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