Please enable JavaScript to view this site.

Version:

You can change the following basemap picker settings:

Main Settings

Title: Type a title to display for the component.

Icon: To select an icon to represent the component, click Select Icon, click the desired icon and click OK. To remove the icon, click Clear Icon.

Additional Basemaps

You can configure two kinds of basemaps for the user to select:

Esri Basemap: These are the well-known standard Esri basemaps.

Custom Basemap: Create your own basemap with whichever layers you want.

Offline Basemap: Create a basemap from Tile Package files (TPK/TPKX/VTPK) that can be used offline.

Basemap layers are typically drawn at the bottom of other layers, although a custom basemap may contain reference layers, which are drawn on top of all other layers.

All basemaps, reference layers and base layers should ideally use exactly the same spatial reference as the web map specified in the Map Settings.

To add an Esri basemap:

1.In the Components panel, select Basemap Picker.

2.In the Basemap Picker panel, click +Add Esri Basemap.

The Esri Basemap window appears.

3.In the Esri Basemap window, from the Basemap menu, select a standard Esri basemap.

4.Click Submit.

The Esri Basemap panel appears.

5.In the Esri Basemap panel, you can set the following:

Title: The title of the basemap as it will appear in the basemap picker.

Basemap: The standard Esri basemap to use as the basemap.

To add a custom basemap:

1.In the Components panel, select Basemap Picker.

2.In the Basemap Picker panel, click icon-down-arrow beside +Add Esri Basemap and click Add Custom Basemap.

3.In the Custom Basemap window, set the following:

Title: The title of the basemap as it will appear in the basemap picker.

Thumbnail Image URL: The URL for an image you want to use as the thumbnail in the basemap picker.

4.Click Submit.

The Custom Basemap panel appears.

5.In the Custom Basemap panel, set the following:

Title: The title of the basemap as it will appear in the basemap picker.

Thumbnail Image URL: The URL for an image you want to use as the thumbnail in the basemap picker.

Reference Layers: These layers are drawn on top of all other layers. They are typically text label layers such as street names.

To add a reference layer:

a.In the Custom Basemap panel, click +Add Layer.

b.Select the reference layers you want to add as part of the custom basemap. You can search for a reference layer to use by name or portal item ID. You can search reference layers you own, reference layers shared with you or public reference layers.

c.Click Select.

To edit a reference layer:

a.In the Custom Basemap panel, in the Reference Layers section, click the name of the reference layer.

b.Change any of the following reference layer settings:

Layer: Click Select to select a different reference layer.

Transparency: The transparency of the offline base layer represented by a percentage between 0 (opaque) and 100 (transparent).

Maximum Scale: The maximum visible scale of the reference layer.

Minimum Scale: The minimum visible scale of the reference layer.

c.Click the back button icon-left-arrow-button.

To reorder a reference layer:

a.In the Custom Basemap panel, in the Reference Layers section, click Edit Items.

b.Drag the reference layer up or down to the position you want.

c.Click Done.

To delete a reference layer:

a.In the Custom Basemap panel, in the Reference Layers section, click Edit Items.

b.Click the Delete icon icon-delete-bin.

c.Click Done.

Base Layers: These layers are drawn at the bottom of the other layers.

To add a base layer:

a.In the Custom Basemap panel, click +Add Layer.

b.Select the base layers you want to add as part of the custom basemap. You can search for a base layer to use by name or portal item ID. You can search base layers you own, base layers shared with you or public base layers.

c.Click Select.

To edit a base layer:

a)In the Custom Basemap panel, in the Base Layers section, click the name of the base layer.

b)Change any of the following base layer settings:

c)Layer: Click Select to select a different base layer.

Transparency: The transparency of the offline base layer represented by a percentage between 0 (opaque) and 100 (transparent).

Maximum Scale: The maximum visible scale of the base layer.

Minimum Scale: The minimum visible scale of the base layer.

d)Click the back button icon-left-arrow-button.

To reorder a base layer:

a.In the Custom Basemap panel, in the Base Layers section, click Edit Items.

b.Drag the base layer up or down to the position you want.

c.Click Done.

To delete a base layer:

a.In the Custom Basemap panel, in the Base Layers section, click Edit Items.

b.Click the Delete icon icon-delete-bin.

c.Click Done.

To create an offline basemap:

1.In the Components panel, select Basemap Picker.

2.In the Basemap Picker panel, click icon-down-arrow beside +Add Esri Basemap and click Add Offline Basemap.

3.In the Offline Basemap window, set the Title of the basemap as it will appear in the basemap picker.

4.Click Submit.

The Offline Basemap panel appears.

5.In the Offline Basemap panel, set the following:

Title: The title of the basemap as it will appear in the basemap picker.

Base Layers: These layers are drawn at the bottom of the other layers.

To add a base layer:

a.In the Offline Basemap panel, click +Add Offline Layer.

b.Type the Title you want for the offline base layer.

c.Click Submit.

To edit a base layer:

d.In the Offline Basemap panel, in the Base Layers section, click the name of the offline base layer.

e.Change any of the following base layer settings:

Title: The title of the offline base layer.

Source: To use an Esri portal item as the source for the offline base layer, click Select, select a layer and click Select.

If the Source setting is set, the File Name setting is automatically set and cannot be changed until the Source is removed. If you set the Source, the Tile Package file (TPK/TPKX/VTPK) does not need to be manually sideloaded onto the device.

If you cannot find the offline base layer, try selecting a different option in the Filter by menu.

To remove the source, click Remove.

File Name: The file name of the Tile Package file (TPK/TPKX/VTPK) for the offline base layer.

If the Source setting is set, the File Name setting is automatically set and cannot be changed until the Source is removed. If you set the Source, the Tile Package file (TPK/TPKX/VTPK) does not need to be manually sideloaded onto the device.

Transparency: The transparency of the offline base layer represented by a percentage between 0 (opaque) and 100 (transparent).

Maximum Scale: The maximum visible scale of the offline base layer.

Minimum Scale: The minimum visible scale of the offline base layer.

f.Click the back button icon-left-arrow-button.

To reorder a base layer:

g.In the Offline Basemap panel, in the Base Layers section, click Edit Items.

h.Drag the base layer up or down to the position you want.

i.Click Done.

To delete a base layer:

j.In the Offline Basemap panel, in the Base Layers section, click Edit Items.

k.Click the Delete icon icon-delete-bin.

l.Click Done.

To edit a basemap:

1.In the Components panel, select Basemap Picker.

2.In the Basemap Picker panel, click the name of the basemap.

3.Change the basemap settings you want.

To reorder a basemap:

1.In the Components panel, select Basemap Picker.

2.In the Basemap Picker panel, click Edit Items.

3.Drag the basemap up or down to the position you want.

4.Click Done.

To delete a basemap:

1.In the Components panel, select Basemap Picker.

2.In the Basemap Picker panel, click Edit Items.

3.Click the Delete icon icon-delete-bin.

4.Click Done.

Layout

Margin (px): The margin space around the component in pixels.

Initially Hidden: Specifies whether or not the component is initially hidden when the app loads. If selected, the component remains hidden unless activated, for example, by the Show command.

Map: The Map component this component affects. This setting cannot be modified if this component is either a subcomponent of a Map component or there is only a single Map component in the app.

© 2026 VertiGIS Ltd. All Rights Reserved. | Privacy Center | Imprint
Documentation Version 5.42 (b071de74)