ArcGIS Online

Create a custom basemap gallery for your organization

A basemap provides the geographic context for the layers you want to display in a map. When you create a new map or scene, you can choose which basemap you want using the basemap gallery.

Basemap gallery
View larger image

By default, the gallery contains a pre-defined set of basemaps from Esri, and is based upon the region you have set for your organization. With administrator privileges in your organization, you can change which basemaps your organization uses by creating a custom basemap gallery. The custom basemap gallery can include a combination of your own basemaps and Esri basemaps. The steps to create a custom basemap gallery are:

Follow the detailed steps below to create a custom basemap gallery for your organization.


Create a group for your basemaps

Create a group that will contain the maps you want to use in your custom basemap gallery. The contents of this group will be shown in the basemap gallery for the Map Viewer or Scene Viewer.

Step 1 – From the Groups tab, click Create group.

Create Group

Step 2 – Complete the Group Details.

a – Add a group name.

b – Add a Summary description for the group.

c – Add one or more tags.

d – Add a thumbnail for the group (optional, but recommended).

Group overview
View larger image

Consider the other group settings, although in this case the rest of the default settings are fine. Ensure that the group is viewable by Everyone (Public) or by All organization members. Note that all maps in the group should be public.

View settings

Click Save when finished.


Tip: After the group has been created, it’s a good idea and a best practice to complete the group description.

Group description


Add maps to the group

Now that you have created a group for your custom basemap gallery, you can add maps to the group. Any map you add will become one of your basemap choices.

You can author maps specifically for use as basemaps. Note that operational layers (anything above the basemap layer group in Content) will not display when used as a basemap. To move a layer to your basemap group, in the Layers pane click the layer options (…) and choose Move to Basemap.

Move to basemap

In the basemaps pane you can also Add Layer.

Add basemap layer

When finished, save the map, ensuring that the map and all layers are shared publicly.

You can also add maps from the ArcGIS Living Atlas of the World, use existing maps in your organization, or even choose publicly shared maps from outside your organization.

To ensure your custom basemaps don’t inadvertently disappear, it’s a best practice to use Living Atlas maps or author and manage your own maps for use as basemaps.


To add a map to your basemap group, follow these steps.

Step 1 – Open the item page for the web map you want to add to your basemap group.

Step 2 – Click Share.


Step 3 – Click Edit group sharing.

Edit group sharing

Step 4 – Select your organization’s custom basemap group from the list of available groups. Click OK when finished.

Share to group

Step 5 – Click Save when finished. The map has been shared to your basemap gallery group.

Save sharing


Set the group as the basemap gallery

Now that you’ve collected the maps you want to use in a group, you can set the group as the Basemap Gallery source for your organization. To enable your custom Basemap Gallery, follow these steps.

Step 1 – Go to your organizations Settings, and open the Map tab.

Setting Map tab

Step 2 – In the Basemap Gallery section, do the following.

a – Select your custom basemap gallery group from the dropdown list.

b – Choose Share basemaps to add the default Esri basemaps to the group. This is optional, but if you only have a few custom basemaps in your custom gallery group adding these will complete your gallery.

Basemap gallery settings

You’ve successfully created a custom basemap gallery, which will appear in all apps.


Summary & tips

A custom basemap gallery can be useful for a variety of reasons. Since the basemap determines the projection of the map, you can add basemaps that support your local projection standard.

A custom gallery also provides flexibility. For example, rather than use Esri’s predefined Living Atlas basemap collection, you can build your own gallery by choosing from available Living Atlas basemaps. You can also use the ArcGIS Vector Tile Style Editor to craft your own unique basemaps based on Esri vector basemaps. Or, author your own basemaps using unique layers published by your organization.

When making your own basemaps, make sure that the maps and all layers are shared publicly. Set the delete protection to prevent accidental deletion of maps and layers.


More information

For more information see the following ArcGIS Online Help topics.

This blog article was originally published on September 10, 2019, and has been updated.

About the author

Corporate technology evangelist and advocate at Esri, focusing on ways to broaden access to geographic information and helping customers succeed with the ArcGIS system. On a good day I'm making a map, on a great day I'm on one. Email or connect on LinkedIn (


Next Article

Analyze stormwater networks using the ArcGIS Utility Network

Read this article