Esri Map
This Block allows you to integrate an Esri Map into the page. An Esri Map has additional features to a regular map such as allowing you to visualize additional geographical information, terrain formation, or topographical information for a given area.
Esri Map Properties
Appearance
Base Map
Choose the visual context for the map from the options listed below:
| Base Map | Description | Thumbnail |
|---|---|---|
| Dark Grey (default) | Shows the world on a gray canvas to focus your attention on thematic content. |  |
| Topography | Shows geographical details including the height and shape of mountains, sea levels, and other geographical features such as rivers. |  |
| Streets | Shows highway-level and street-level data for the world. Major roads are highlighted and all roads are labeled. |  |
| Streets Night | Shows highway-level and street-level data for the world, designed for use at night or in a low light environment. Major roads are highlighted and all roads are labeled. |  |
| Satellite | Shows high-resolution satellite imagery for many areas. |  |
| Hybrid | Shows high-resolution satellite imagery for many areas, with road labels or location references overlaid on top. |  |
| Gray | Shows the world on a light gray canvas to focus your attention on thematic content. |  |
| National Geographic | Provides a detailed view of political boundaries, and emphasises certain characteristics of the land such as mountains. |  |
| Oceans | Designed for Marine GIS professionals to provide important reference points within the Oceans and Seas of the world. |  |
| Open Street Map | Open Street Map (OSM) is a collaborative project to create an open, editable neighborhood map. The Esri replica is updated continuously with the latest edits. |  |
| Terrain | Shows terrain details including the height of the land and sea. |  |
Allow pan and rotate
Adds a button to the map which allows the user to rotate the map.
Longitude, Latitude, Height, and Tilt Angle
The map will load the location specified with Longitude, Latitude, Height, and Tilt Angle.
Behavior
Authentication Mode
Choose how the Esri Map authenticates with ArcGIS: API Key (default) or App Authentication (OAuth 2.0).
API Key uses a single key to unlock private feature layers; leave it blank if you are not using feature layers. See Use Variables and API Key below.
App Authentication (OAuth 2.0) authenticates as a registered ArcGIS OAuth 2.0 application, using the client credentials grant. Access tokens refresh automatically before they expire, so no user sign-in is required. Register an OAuth 2.0 application in ArcGIS (ArcGIS Online or ArcGIS Enterprise) with the Client Credentials grant type, then see Client ID, Client Secret, and Portal URL below. For more details, visit the official Esri App Authentication documentation.
Warning
An incorrect Client ID, Client Secret, or Portal URL shows an authentication error instead of loading the map.
Use Variables
This allows you to choose between manually entering a value for the API Key or selecting from a static variable (applies to API Key Authentication Mode only).
API Key
The API key unlocks private feature layers. For more details, visit the official Esri map documentation.
Required when feature layers are configured (applies to API Key Authentication Mode only).
Client ID
The ArcGIS OAuth application's unencrypted Variable holding its Client ID. Required (applies to App Authentication (OAuth 2.0) Authentication Mode only).
Client Secret
The ArcGIS OAuth application's encrypted Variable holding its Client Secret. Required (applies to App Authentication (OAuth 2.0) Authentication Mode only).
Portal URL
The ArcGIS portal to authenticate against. Defaults to https://www.arcgis.com; for ArcGIS Enterprise (on-premises) deployments, enter your organization's portal URL instead, for example https://gis.example.com/portal. Must use HTTPS (applies to App Authentication (OAuth 2.0) Authentication Mode only).
Show Basemap Gallery
This will add a button on the map and give the option to change the Base Map layout.
Allow Show Current Location
This will show the user's current location on the map. Requires the location of the device.
Feature Layers
A Feature Layer is a single layer overlaid on the base map that can be created in a variety of ways and display different visualizations. Spatial feature layers include features that use Geometry and allow you to render the scene in either 2D or 3D. These features also provide more information about the real world which can be displayed through pop-up windows within the scene. Non-spatial feature layers do not provide this information about geographical features.
For more details, visit the official Esri Map documentation.
Markers Data Source
Mode
This can be changed to either use Static Items or a Dynamic Data Source. In both cases, markers need to be configured in the Data section. If the static items option is chosen, markers for locations can be entered manually under the Data section. If the Dynamic Data Source option is chosen, marker locations coming from the Data Source can be used.
See the Common Properties article for more details on common Data Source properties.
Data
Markers for locations can be manually added and they will show on the map. Actions are triggered when you click on a marker on the map. Markers are entered by Longitude and Latitude. Markers can also have a text label that will be shown on top of the marker.
Action
Common Properties
Actions are triggered when you click on a label marker on the map.
Properties that are common to most Blocks include: navigate to and show confirmation dialog;
See the Common Properties article for more details on common action properties.
Last modified: September 23, 2026