Skip To Content

Change the default basemap

The basemap that is displayed by default in a map is the default basemap specified in your organization's ArcGIS account. You can specify a different default basemap by changing the Default Basemap setting in your ArcGIS account or by editing the baseMapLayers section of the map_configuration.json.txt file.

The following instructions describe how to change the default basemap by editing map_configuration.json.txt.

  1. On each EM4C Gateway in your environment, make a copy of map_configuration.json.txt.default, located at <em4c_location>\webcontent\esrimap\em4c-bisprovider\config\design.
  2. Rename the copy to map_configuration.json.txt.
  3. Find the following section in map_configuration.json.txt:
    "itemData": {
    }
  4. Modify the baseMapLayers section to reflect your basemap's unique ID and the URL to its REST endpoint, for example:
    "itemData": {
      "baseMap": {
        "baseMapLayers": [
          {
            "id": "123456",
            "url": "http://services.arcgisonline.com/arcgis/rest/services/ESRI_StreetMap_World_2D/MapServer"
          }
        ],
        "title": "New default Base Map"
      }
    }
  5. Validate your JSON code using a validation tool such as JSONLint.

    The newly specified default basemap will be used in all new map configurations, overriding the Default Basemap setting in your ArcGIS organizational account.

    If a report author wants to use the basemap specified in the organizational account for a particular report instead of that specified in map_configuration.json.txt, they must reset the appropriate map or maps in Esri Maps Designer.

    Note:

    Any changes made to map_configuration.json.txt, including specifying a template, or default map, will override the Default Basemap setting in your ArcGIS organizational account.

  6. Save and close the file.