Skip To Content

Configure a map widget

A map widget displays the content of a map and provides access to the data the map contains. The data is available through configurable tools that work with the map as well as through data sources that other widgets can consume.

A map widget is often the primary data provider for the operation view, and map layers serve as a data source for other widgets. For example, your map widget might contain damage reports and evacuation shelter occupancy levels following an earthquake, which can then display in a chart or gauge widget.

Map widget

Add a map and configure data sources

Maps used in the operation view are authored and saved in your ArcGIS organizational account. These maps can contain one or more layers. When you add a map widget to the operation view, you can set options for the map's layers, including the individual layers that serve as data sources for other widgets and whether the features are selectable. You can also create a filter with a query to create a data source that only includes a certain set of features from the layer and is usable by other widgets.

With a map of operations related to an earthquake emergency management scenario, you might have a combination of settings among the layers. For example, some layers could be dynamic and refresh at an interval while others are static references. The dynamic layers in the map could include point layers of fire truck and police car positions that are being reported regularly through GPS. You are also likely to want to use these layers as input data sources for other widgets, such as a gauge widget that shows the remaining fuel quantity of each vehicle. On the other hand, the same map could have a roads layer that does not change. The roads are also not going to be used as inputs to other widgets, so you do not need to set it as a data source.

  1. Click Edit, and click Edit Operation View.
  2. To create a new widget, click Widget, click Add Widget, choose the type of widget, and click OK. To update settings for an existing widget, click Settings Settings, and click Configure Configure on the widget's window.
  3. Browse or search for the map you want to use in the widget. You can click Details to get more information about a map. When you find the map, click it and click Open.
  4. In the Title box, type a title that will be displayed in the widget's window.
  5. On the Data Sources tab, check each layer that can provide data for other widgets. Only map and feature layers can be data sources. Basemaps and other data that is not supported as a data source will not be listed on this tab.

    Hosted feature layers and ArcGIS 10.1 Server (and later) feature and map services are supported as data sources. If your map contains ArcGIS 10.0 Server feature or map services, they are visible, but disabled, on the Data Sources tab.

  6. For each data source layer, set whether the features can be selected in the map. You can also review the refresh interval set for dynamic layers.

    By default, layers with a refresh interval in the map are set to dynamic, and the specified refresh interval is honored.

    When editing the operation view, you can override the refresh interval on each layer in the map with a single refresh interval for all dynamic layers. To specify a single refresh interval, go to the Widgets menu and click Refresh Settings. Set the refresh type to use a single interval to update data sources, and specify a refresh interval. When using a single refresh interval, you can also override for each layer whether it is static or dynamic.

  7. Optionally set a filter so that the data source only includes features that satisfy a query. Use the Add, Remove, and Configure buttons on the Data Sources tab to set a filter, include all features again, and edit the definition.

    This filter creates a new data source that can be used in other widgets and does not apply to the data displayed in the map widget. Users cannot change or disable a filter set on a data source. For details on filters, see Filter data.

  8. Click OK to finish configuring the widget.

Configure capabilities

In addition to configuring the data sources for your map widget, you can configure how a user can interact with the map in your operation view, including available feature actions and whether tapping or clicking a feature displays its pop-up.

Feature actions add display and navigation functions to individual features. For example, the highlight action allows users to flash a feature, while follow tracks a particular feature as it moves without having to pan manually to keep the feature centered in the map.

Feature Pop-ups enables users to tap or click a feature on the map to display the pop-up. The content of the pop-ups is authored and stored within the source map. For pop-ups to be used effectively in a map widget, they should have been authored with understandable field names, only useful and appropriate fields, properly formatted text, and images or hyperlinks, if desired.

  1. Click Edit, and click Edit Operation View.
  2. Click Settings Settings and click Configure Configure in the map widget's window.
  3. Click the Capabilities tab.
  4. Check the feature actions that will be available when interacting with individual features in the map. For example, users can press and hold or right-click a feature to follow it on the map, zoom or pan the map to it, or highlight it on the map.

    Directions from here and Directions to here are not supported in the browser.

  5. Check the other capabilities that will be available in the map. Enable Feature Pop-ups to display a pop-up containing information about a feature by tapping or clicking the feature. Enable Coordinates to show the coordinates of the current cursor location.

    Display of coordinates is not supported in touch mode or in the browser.

  6. Click OK to finish configuring the widget.

Configure map tools

When configuring a map widget, you can enable additional map tools for users of your operation view, such as spatial bookmarks and feature selection. These tools are displayed on a toolbar within the map widget. Basic map navigation, such as panning and zooming, is always available in a map widget and does not require you to enable any additional functionality.

  • Basemaps allow users to change the basemap for the map by choosing a new one from the standard gallery.
  • Bookmarks allow users to navigate to saved map extents. You need to author and save the bookmarks in the map; you cannot create bookmarks in the operation view. If you enable bookmarks for a map widget and no bookmarks exist in the source map, the list of bookmarks is empty.
  • Driving Directions calculates a route between locations.

    Driving directions are not supported in the browser.

  • Find Places adds search capability to a map widget. Users can search the map for an address, x,y coordinate location, or a feature. If a single result is found, the map centers on the location and displays a pin at the position. If multiple results are found, they are presented to the user. Tapping or clicking a single result pans and zooms to its location.

    When creating the map, configure the search in the item details page of the map. Choose which search types to enable: By Layer, By Address, or both. Provide hint text so that users of your operation view know what they can search. For layer (feature) search, provide the field to search and the search operator to use. For more information, see Configure feature search in the ArcGIS Online help.


    Each layer can have a single search configured on its features. Feature search was added to Portal for ArcGIS at 10.3. Feature search is not supported in the browser.

    When configuring the Find Places map tool, you need to specify which unit notations, such as latitude-longitude or MGRS, are valid for input; only results for the formats you choose are returned in a search. The Find Places box appears in the map widget window.

  • Layer Filters allows you to define a query to display only the features that satisfy a query. When enabled, the filter applies to all widgets that use data from the filtered layer, including the map. You can create multiple filters and the user can enable or disable each one.

    A filter set on the data source in the map widget configuration is always enabled, compared with those in the Layer Filters tool that can be turned on or off by the user.

  • Link Map Extents synchronizes navigation between maps. As the user zooms or pans one map, other map widgets can update to the same scale and center point. You need to include the tool in each of the map widgets that need the ability to be linked. The user can turn linking on or off for each map by tapping or clicking the tool.
  • Map Contents provides users with the ability to turn layers on and off. You need to specify which layers are listed; if you want a layer to be displayed all the time, do not include it in the Map Contents widget.
  • Measure provides tools to measure distances and areas and obtain coordinate locations on the map. You specify which units are available for measuring.
  • Select Features enables interactive selections on the features in the map widget. The selections can be used as data sources for other widgets that show information about the currently selected feature.
  • Clear Feature Selection clears the selection on the map.

  1. Once you add a map widget, click Add, remove, and configure map tools Map tools.
  2. Check the tools you want to be available in the map widget. For example, you can allow users to measure distances, turn layers on and off, synchronize map extents, or select features. Some tools, such as Layer Filters and Find Places, require additional configuration.

Filter data

In some cases, you may want to work with only a subset of features that have a particular attribute value or fall within the current extent. For example, when mapping earthquake reports, if the layer contains polygons for recent earthquakes in other regions, you might want to limit the data source to only features that are from the incident you're mapping. Because earthquakes are often given a name attribute, you could create a filter with a query to display just the polygons that match the name of your event. You might also want to add a filter that queries a date field to identify aftershocks that have occurred within the last six hours, or limit your results only to the features that are in the extent of the map you are viewing.

There are three places where you can create filters for your operation view: in the map, using the Layer Filters tool, and on a data source from the map. The type of filter you create determines how that filter can be used.

FilterIn the mapUsing the Layer Filter toolOn a data source from the map

Affects map widget (display)



Affects other widgets




User can turn it on and off



With the map

In the Layer Filter tool's settings

During map widget configuration

Limit to current extent

Optionally specified by the author during map widget configuration

Use cases

When the user never wants to see or know about parts of the data

When the user can toggle the filter to change the operation view data

When a particular widget is about a subset of the data