Skip To Content

Configure a custom basemap

Available with Defense Mapping license.

ArcGIS Enterprise comes preconfigured with a collection of basemaps that can be used with the self-serve Map Production System (MPS) web app. These include basemaps from ArcGIS Online or map services outside of Esri. The following basemaps are available from Esri:

For organizations with limited or no internet access, you can configure custom basemaps locally for disconnected deployments.

Add a custom basemap

To use custom basemaps, an item must be created in the same Enterprise portal that contains the MPS app. The created item can reference the service URL of a custom basemap. This also allows the custom basemap’s service to be secured using the service credentials stored with the item. The following steps describe how to add an Esri-provided custom basemap for use with the MPS app:

  1. In the portal hosting the MPS app, create an item from a service URL.
    New item dialog box with URL details

    Providers of non-Esri basemap services may make URL available on their website.

  2. Create a group for the basemap.

    Users that are added to this group can use, add or share basemaps as items to the portal.

    Caution:

    You must be assigned an administrator role or assigned a custom role with privileges to alter portal settings.

    Learn more about groups

  3. Share the basemap with the group.
  4. Click the Content tab in your organization portal and browse to the MPS app item.
  5. Click the item to open the Overview page, then click View to open the app.
  6. Click the user icon to access the app's settings.

    You must be the app owner to access the Settings page.

  7. In the General Settings section, check the Use portal-configured basemaps check box.
  8. Verify that the basemaps you shared to the group appear as Basemap options for a map product in the Product Settings section.
    Product Settings Basemap options

The configured basemaps are available in the Basemap section for each map product. Only the basemaps that are shared with the basemap group appear. These are also the basemaps that will be available in the app.

Configure a local basemap

If your organization deploys Enterprise in a disconnected environment, you can still use custom basemaps by creating a tile package in ArcGIS Pro that you can use locally from your organization's Enterprise portal. The portal item is swapped with the basemap of a map in Map Viewer and saved to a custom basemaps group.

Learn more about custom basemaps

Create a tile package

Complete the following steps to create a tile package that you can use locally:

  1. Open a map project in ArcGIS Pro.
  2. Customize the map as necessary.

    This becomes the basemap available to use locally.

  3. Create a map or vector tile package.
    Note:

    This range specified for the level detail or cached scale impacts how long it takes to run the tool.

    Learn more about cache and tiling format

    Alternatively, you can publish a map service and configure the caching properties, and generate a vector or raster tile cache.

    Learn more about publishing hosted tile layers

    Learn more about authoring a map for vector tile creation

A tile package is ready to be configured in your organization's Enterprise portal.

Configure a group and add the tile package

Complete the following steps to create a group that contains the tile package as a hosted layer. Access can be configured in the group settings.

  1. Create a group in your organization's portal.

    Configure the group so that members can use, add, or share basemaps as items to this portal.

    Caution:

    You must be assigned an administrator role or assigned a custom role with privileges to alter portal settings.

    Learn more about groups

  2. Click the Organization tab, then click Settings.
  3. Click Map.
  4. In the Basemap gallery section, choose the group that you created.

    Do not click Share basemaps.

  5. Create a new item in your organization's portal and add the tile package file.

A hosted tile layer is created and its overview page appears.

Add and share the tile layer as a basemap

Complete the following steps to open the hosted tile layer in Map Viewer and set it as the basemap so that you can save and share it:

  1. From the hosted tile layer's overview page, click Open in Map Viewer.

    Map Viewer opens.

  2. Click Options on the tile layer and choose Move to basemap.

    The layer moves to the Basemap pane.

  3. Open the Basemap pane.
  4. Remove the default Esri basemap if there is one.
  5. Optionally, rename the tile layer.
  6. Save the map in Map Viewer.
    Save as option in Map Viewer
  7. Share the map with the basemaps group you created.
  8. Repeat this process to add more tile layers as basemaps.

    You can verify that tile layers were saved as basemaps by opening the Basemap pane.

The basemaps are in your organization's portal that you can access locally.

Use the basemap in the MPS app

Complete the following steps in the MPS web app to make the basemaps you configured available:

  1. Access the MPS web app's settings.
  2. In the General Settings section, check the Use portal-configured basemaps check box.
  3. Verify that the basemaps you shared to the group appear as Basemap options for a map product in the Product Settings section.
    Product Settings Basemap options

The configured basemaps are available in the Basemap section for each map product. Only the basemaps that are shared with the basemap group appear. These are also the basemaps that will be available in the app.

Related topics