Error: Basemap is not available. Displaying the default basemap instead
In ArcGIS Online, opening a web map returns the following error:
Error: Basemap is not available. Displaying the default basemap instead.
The following are possible causes for this issue.
- Certain web browsers and browser settings can prevent web sites with mixed content from drawing completely.
- The basemap may be temporarily offline.
- ArcGIS Online is referencing an incorrect tile layer URL. This can occur if the tile layer is deleted before being updated or if the name of the tile layer is changed.
- Incorrect security settings. The organizations security settings use HTTPS, however the service URL for the basemap is referencing a HTTP URL.
In addition, there are known issues in ArcGIS Online and Portal for ArcGIS caused by BUG-000099434, which is triggered when a web map is opened that references an unavailable basemap.
Solution or Workaround
Try one of the following workarounds to solve this issue.
- Temporarily disable any extensions installed in the browser that may interfere with the ability to load the basemap, such as Privacy Badger.
- Configure the ArcGIS Online security settings to allow HTTPS connections. The following ArcGIS Online document describes this in detail: Configure security settings.
Note: Organizations can apply a domain filter to determine the domains that are allowed and restricted within the organization. The following document provides a list of URLs, which must be added into the organizations whitelist for ArcGIS Online to have full functionality: Domain Requirements for ArcGIS Online.
- Only use browsers supported by ArcGIS Online. The following ArcGIS Online document describes this in detail: Supported browsers.
- Ensure that Cross-Origin Resource Sharing (CORS) is enabled in the web browser. The instructions in the following page describe how to enable cross-origin requests in each browser: Cross-Origin Requests in Internet Explorer, Firefox, Safari and Chrome page.
- Use the ArcGIS Online Assistant to manually repair the service links of the updated tile layer. Replace the tile layer's service URL with the newly updated service URL.
Note: The ArcGIS Online Assistant can also be used to determine if mixed content is used by inspecting the web maps JSON. The following document explains the behavior of using mixed content in ArcGIS Online: Troubleshoot.
- Esri Technical Support Blog: Troubleshooting issues adding ArcGIS Online basemaps to ArcMap
- FAQ: What are the required firewall domain exceptions for accessing ArcGIS Online?
- Problem: Unable to load the ArcGIS Online basemap gallery