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 click Type to search for specific data types (such as feature layers, elevation layers, scene layers, and group layers). You can click Sort by to sort items by when they were modified, by title, or by number of views.

    Note:

    ArcGIS Living Atlas of the World includes three levels of content: publicly available content, subscriber content, and premium content. Subscriber content, such as Landsat 8 imagery, requires an organizational subscription account to access. Premium content is subscriber content that consumes credits, such as demographic and lifestyle layers.

    If you include the Add Data widget in an app and share the app publicly, the widget prompts the user to sign in when they try to add subscriber or premium content. Public users can add public items from ArcGIS Online and ArcGIS Living Atlas and can add by URL and from local storage without being signed in.

    The widget supports adding whole subtype group layers, but not individual subtype sublayers.

    Note:

    Feature collections containing multiple layers appear in the Group Layer category when you filter by layer type.

  • 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.

    Note:

    You can add the data in the following formats by both Search and URL: feature service, map service, vector tile service, image service, scene service, KML, WFS, WMS, WMTS, GeoJSON, and CSV.
  • 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.

    Note:

    Uploaded .csv files are limited to a maximum of 1,000 records, and all other supported file types are limited to 4,000. The maximum upload size is 2 MB for a shapefile and 10 MB for all other file types.

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.