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. Make a copy of map_configuration.json.txt.default, located at <MicroStrategy_plugin_directory>\javascript\configuration\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 designer 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.

    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.

    Note:

    To make this change available in Report mode, Presentation mode, and Mobile mode, copy the map_configuration.json.text file to the following directories:

    • <MicroStrategy_plugin_directory>\javascript\configuration\report
    • <MicroStrategy_plugin_directory>\javascript\configuration\document
    • <MicroStrategy_plugin_directory>\javascript\configuration\mobile

  7. Clear your browser cache.

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