The layer, '<Basemap Name>', is not compatible with the current basemap. To add the layer, add it to the map as the basemap

Error Message

When a layer is added to a map, the basemap is removed, and when attempting to add a basemap, it fails and returns the following error:

Error: 
The layer, '<Basemap name>', is not compatible with the current basemap. To add the layer, add it to the map as the basemap.

Cause

This is an expected behavior. Different basemaps use different spatial references. When a layer using a different spatial reference is opened in Map Viewer, the basemap is removed from the map. In the example above, the tile layer is not compatible with the World Topographic Map basemap from Living Atlas.

Solution or Workaround

Use one of the following solutions to solve the issue:

• Use a different basemap and add the layer. Refer to Portal for ArcGIS: Choose a basemap (Map Viewer) for instructions.
• Republish the feature layer with a different coordinate system. Refer to Portal for ArcGIS: Publish hosted feature layers for instructions.