Add Data widget

The Add Data widget allows you to temporarily add data sources to the app at run time. You can add data from ArcGIS content, a URL, or local storage. You can manage and filter added data and view data in maps and tables. Importantly, you cannot save data.

Examples

Use this widget to support app design requirements such as the following:

  • You want users to be able to view their own data overlayed with your organization's data.
  • You want to map .csv and .geojson files from an open data portal without having to upload them as ArcGIS items.
  • You want users to quickly view any shapefile on a map without having to use desktop or subscription software.

Usage notes

When you include this widget in an app, the widget provides the user with the following interaction options:

  • Click to add data—Open the Add data panel. When there is no added data, this button appears along with an empty list message, which you can customize in the widget's settings.

    • Search—Search for content stored as ArcGIS items. You can browse and search for data sources in your content, your groups, your organizations, and content that's shared publicly, including ArcGIS Living Atlas of the World. The widget supports advanced keyword search to narrow the results. You can also click the Type button to search for specific data types (such as feature layers, elevation layers, scene layers, and group layers).

    • URL—Add layers or web services by URL. The drop-down menu lists the types of data that you can add by URL. You must select the appropriate type to add data of that type by URL.

    • File—Add data by dragging files to the widget or by browsing local storage. Currently, you can upload data in the following formats: CSV, GeoJSON, KML, GPX, and shapefile.

You can rename or delete an added data item in the runtime panel.

Settings

The Add Data widget includes the following settings:

  • Way of adding data—Turn on methods (Select from account, Input URL, and Upload files) to include them in the widget at run time.

    • Under Select from account, you can view the options that appear in the search drop-down menu at run time. Drag to reorder these options. Double-click or use the edit button to rename them.
    • Curate a collection—Add an option to the search drop-down menu. You can use data collections to pre-enter search terms. For example, type Wildfires under Curated filter to make a drop-down option that shows wildfire-related content. The string you enter must be either an advanced search field plus a valid value (for example, id:123456789) or tags (for example, Wildfires).
  • Empty list message—Customize the text that appears when there is no added data.

Interaction options

This widget supports setting a trigger on the Action tab in the widget's settings. With Experience Builder, you can use triggers and message actions to create interactions between widgets. For example, you can set the Data added trigger to target a Map widget, which causes the map to automatically display any layers when they are first added. The widget also supports data actions for individual layers, such as View in table, Zoom to, and Pan to. If you choose not to configure the Data added message action, you can enable the Add to map data action to allow users to manually add each data source to the map.

Learn more about adding actions to widgets

Two data actions, View in table and Set filter, are only available when the added data is a feature layer or scene layer with an associated feature layer. If you set filter clauses for a data item, all other widgets that use that data (such as maps and tables) are filtered.

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.