What's new 1.18

Builder updates

ArcGIS Experience Builder 1.18 includes several new features and enhancements as listed below:

• Accessibility—Seven more widgets support accessibility features—Add Data, Feature Info, Feature Report, Flow Row, Measurement, Select, and Sidebar. The Compact mode in the Print widget supports accessibility features. You can use the Shift+Space keys to select rows in a Table widget. Four more default templates are optimized for accessibility—Gallery, General, Skyline, and Summary.
• Actions—Adds two new message actions—Open view and Toggle widget—and the Add marker data action. Open view opens a specific view in a Section widget. Toggle widget opens and closes widgets in a Widget Controller widget. You can use the new Add marker data action to add marker point symbols to the map that represent point, line, and polygon features. For a point, the marker appears at the same location as the point. For lines and polygons, the marker appears at their centroids. Additionally, the View in table and Add to table data actions have a new Open in the same sheet setting. If you turn on this setting, then when you add data or view data in a table for the first time, the table adds a new sheet. When you add or view data subsequent times, the new data replaces the previous data in the same sheet instead of adding more sheets. You can now export to Shapefile, FGDB, and KML with the Export data action.
• Advanced formatting—Adds support for advanced formatting, which includes advanced dynamic content and dynamic styling. Advanced dynamic content involves running calculations with data and returning dynamic values to display as widget content, specifically text, image sources, and links set by URL. You can use Arcade expressions to create advanced dynamic content. Dynamic styling involves updating widget backgrounds, borders, and other visual elements based on data. You can use both Arcade expressions and conditional styling, a no-code feature, to create dynamic styling. You can dynamically style Text widgets, Button widgets, and list items in List widgets.
• Builder—From the Data panel, you can copy a data source ID by clicking the Copy data ID button. This new button appears on data source item cards and in the data details panel. It also appears for data views if you hover the pointer over the view. Experience Builder now honors organization content search settings, meaning you can search for maps, layers, utility services, and other content owned by users outside of your organization if your administrator enables it in organization security settings.
• Data—You can use Arcade to add data sources to an app. Additionally, Experience Builder supports three new field types—Big integer, date only, and time only. A big integer field is a type of number field. It is a 64-bit signed integer that can store very large whole number integer values within the range of -(253) -1 and 253 -1. Date only and time only fields are similar to date fields but each only represents their respective type of values. Date only fields store date values with no time values and time only fields store time values with no date values.
• Embedding—There are new rules for sharing authentication. ArcGIS uses token-based authentication for all access requests. When you embed an Experience Builder app in another ArcGIS app with the arcgis-auth-origin URL parameter, the Experience Builder app requests an access token from the parent app. The parent app decides whether to reply to the token. When you embed another app in an Experience Builder app with the Embed widget, the parent Experience Builder app only replies to the token request if the child app is under the *.arcgis.com domain or the same domain as the parent Experience Builder app.
• Express mode—Triggers now only appears in the Message action section of widget settings if there is at least one supported target currently in the app. Additionally, the first two web maps or web scenes that you add in the Select data panel connect automatically to the Map widget and display on the canvas. If you add three or more maps or scenes, you can choose which one or two to connect to the widget.
• General settings—You can use the new Experience state setting to restore an app interface to its previous state when you re-open the app. Experience Builder stores information about the current app state in the browser cache. App state information includes which page, view, or window is currently open, the map viewpoint, and layer visibility. If you turn on the Experience state toggle switch, the Restore experience state banner appears when you launch the app after having closed it before. The banner prompts you to restore the app to its previous state. It disappears automatically after 10 seconds. The banner appears if there is any saved state information in the browser cache. Additionally, you can use the new Security settings to turn off sign-in prompts. Specific parts of an Experience Builder app may prompt users to sign in with an ArcGIS account. You can turn off prompts that ask users to sign in the view unshared resources. If you do, the app only loads content that is accessible to the current user. You can also turn off the credential banner, which is the banner that appears if an includes widgets, data, utility services, or other components that require an account with certain privileges.
• Languages—NO is now the official abbreviation for Norwegian languages in app URLs. The previously used abbreviations NB (Norwegian Bokmål) and NN (Norwegian Nynorsk) automatically switch to NO.
• Pending list—The pending list is now organized based on where widgets appear in the app. In the Pending tab of the Insert widget panel, widgets that are in the app in at least one device mode now appear in a list under Other devices used. Icons indicate which device modes have each widget. Widgets that are currently not on the canvas in any device mode appear under All devices unused.
• Templates—Adds the Harbor full-screen page template and the Beacon scrolling page template. You can use the new Capabilities button to filter templates based on which widgets and other features they have. The button appears in the template gallery, the Add page panel, and the Add window panel.

Widgets

Other improvements include the following new and updated widgets:

• Display Order widget (new)—Define the rules for mosaicking and displaying overlapping images. A mosaic is a combination or merge of two or more images. You can use this widget to create a mosaic from an ArcGIS imagery layer with a mosaic dataset.
• Document Explorer widget (new)—Explore files and folders from Autodesk Construction Cloud (ACC) and BIM 360 projects. This widget functions as a file navigation tool and lists documents in a drop-down folder structure. You can select a document with the Document Explorer widget and view its content with the new Document Viewer widget.
• Document Viewer widget (new)—View and interact with Autodesk Construction Cloud (ACC) and BIM 360 documents.
• Link Explorer widget (new)—View Autodesk Construction Cloud (ACC) and BIM 360 project documents that are linked to features in a web map or web scene. You can use this widget to select documents and display them in the new Document Viewer widget.
• Add Data widget—Adds a Copy button that you can use to copy the sample URLs that appear when you add data by URL. When you add data by uploading a file, any layer symbology from the file is preserved when you add the data to the map.You can use the Data type restriction drop-down menu in the widget settings to limit which type of data users can add at run time.
• Analysis widget—For input feature parameters, by default Experience Builder sends feature layers to the geoprocessing server as service URLs. You can check the new Send Feature Collection instead of URL check box to send data directly as a feature collection from the client side. You should check this check box if the input feature layer is private and the geoprocessing server cannot access it without credentials, or if the geoprocessing tool only accepts feature collections and not service URLs.
• Business Analyst widget—You can use the new Always use latest data source setting to make the widget automatically select the latest available data source. Currently, this setting only appears if you select the United States as the country. Data for the United States updates annually. Additionally, there is a new infographic template category called Esri Tabular Reports, which includes report templates modelled after the classic Esri reports from ArcGIS Web AppBuilder.
• Chart widget—You can label pie chart slices by category name in data label, hover labels, and legends.
• Directions widget—You can use the new Enable route saving setting to choose whether to include the Save and Save as tools in the widget panel at run time. You can set default barrier layers in the widget settings with up to 250 point barriers, 500 line barrier intersections, and 2,000 polygon barrier intersections per routing request. You can also set default start and end points in the widget settings.
• Draw widget—Adds the freehand polyline and freehand polygon drawing tools. You can edit the symbology of graphics you have already drawn with the widget. You can edit multiple graphics at the same time if you select multiple graphics that are the same geometry type.
• Edit widget—Supports batch editing for 2D data. You can select many features from a single layer and update their attributes at the same time. You can also move, rotate, and change the sizes of multiple features at once. The new Enable segment label tool adds labels that show the lengths of line segments for features you create in 3D scenes. You can click and drag layers to change their order. You can connect the Edit widget to data you add to the app with Arcade expressions. Additionally, layers now load much faster in the Edit widget.
• Elevation Profile widget—You can choose to keep or clear results when you close or hide the widget. This feature is useful if you want to place the widget on a different page from the connected map, inside a window, or in a Widget Controller widget, Sidebar widget, Accordion widget, or Section widget view.
• Embed widget—When you connect the widget to data and embed by dynamic URL, you can use the Blank message setting to enter a message to display when a URL generated from the data resolves to blank values. With this update, *.arcgis.com is the only safe domain excluded from having the sandbox attribute added to iframes.
• Feature Report widget—You can generate reports from all feature layers, not just feature layers associated with an ArcGIS Survey123 survey. If you generate reports using a feature layer, the report template is attached to the feature layer. If you generate reports using a survey, the report template is attached to the survey.
• Filter widget—When you create a filter with pre-defined values, you can now change the order of the values by clicking and dragging values and by sorting. With attribute fields, you can sort by value. With domain fields, you can sort by label or domain value. The default order for sorting by value is ascending order.
• Floor Filter widget—Adds new settings that you can use to filter data in data-centric widgets based on the selected floor, or set the floor based on selections you make with data-centric widgets. The Filter data by selected floor and Display selected floor only settings are appropriate if you want the Floor Filter widget and map to be the focus of a page so other widgets update based on selections made with the Floor Filter widget. The Switch floor on feature selection and Zoom to selected floor settings are appropriate if you want another widget to be the main way to interact with data on a page, so the Floor Filter widget and map update based on selections made with that widget. It is recommended that you turn on either the former or latter pair of settings, not all of them at the same time. Additionally, you can use Arcade to automatically populate fields for new floor-aware features created with the Edit widget.
• Flow Row widget—Adds two horizontal alignment options—Space around and Space between. Space around positions nested widgets in the row with the same amount of space to the left and right of each widget. Because each widget has the same space around it, widgets at the left and right ends of the row are closer to the row's edge than they are to each other. Widgets have two units of space between them, one from each widget. Space between positions nested widgets in the row with the same amount of space between adjacent widget. Widgets at the left and right ends of the row align with the row's edges based on the specified padding.
• Image widget—You can add the Image viewer expand button to the corner of the image. Click the expand button to open a large version of the image. A zoom tool allows you to zoom in on specific parts of the image. You can zoom and pan the image. The zoom magnification value can range rom 10% to 1000% of the starting size. Additionally, if an Image widget displays multiple images, such as multiple attachments for one feature, you can use the arrow buttons that appear in the widget to cycle through all of the images. On touch-screen devices, you can swipe through the images.
• Legend widget—You can turn on Customize layers to choose which layers from the connected map appear in the legend. You can also choose to include layers added at run time with widgets such as the Add Data widget.
• List widget—The record count shows a thousands separator for values greater than or equal to 1,000. A check mark indicates which sort field is active with the Sort tool.
• Map widget—You can use the marker:<x><y> URL parameter to add a marker to the map. The marker appears on the map at the specified x and y location. Optionally, you can specify a coordinate system well-known ID (WKID), a title for the marker pop-up, a label that appears next to the marker, and a symbol for the marker. You can add multiple markers with different properties by entering their information in the URL in JSON format. You can also add markers to a map with the Add marker data action, which you can configure in the Action tab of the settings of other widgets. Additionally, Automatic is the new default scene quality mode. In automatic mode, the widget uses a different scene quality depending on the detected browser. Scene quality is low for all browsers on iPhones and medium for any other browser.
• Map Layers widget—You can change symbols for layers added at run time with widgets such as the Add Data widget. Select Use predefined symbols to keep the original symbols. Select Use custom symbols to customize point, line, or polygon symbols. You can change symbols for feature layers, oriented imagery layers, map image layers with the supportsDynamicLayers capability enabled, CSV layers, GeoJSON layers, and subtype sublayers.
• Measurement widget—You can turn off snapping for 2D maps.
• Near Me widget—Adds more map elements to PDF exports. The scale bar and north arrow appear in the PDF export when you turn on those tools in the settings of the connected Map widget. Map attribution appears for the map in the PDF. Labels showing the dimensions of the area of interest appears in the PDF when you search by location. The date and time of the export appear and are editable. You can hide the legend from the PDF. PDF reports honor group and subgroup settings when they are configured. Additionally, you can choose to keep or clear results when you close or hide the widget. This feature is useful if you want to place the widget on a different page from the connected map, inside a window, or in a Widget Controller widget, Sidebar widget, Accordion widget, or Section widget view.
• Oriented Imagery Viewer widget—You can use the Directional navigation tool to navigate through images with directional arrows that indicate whether there are more images available next to the current image. Click an arrow to transition to the next image. If an arrow is not visible, it means there are no images available in that direction. You can use the Sequential navigation tool to navigate through images in the viewer with previous and next buttons. The order of images is determined by their order in the user-defined field SequenceOrder. There are three new image measurement tools that use triangulation to calculate distance, area, and point coordinates from multiple images. The widget can display videos if the connected web map includes oriented imagery layers with video compatibility.
• Print widget—You can define the output spatial reference for printing. By default, the widget uses the spatial reference of the basemap in the connected Map widget. You can change the output spatial reference by entering a valid well-known ID (WKID).
• Search widget—Results that start with the input search term appear first in search results.
• Select widget—When you connect the Select widget to a Map widget, you can click and drag layers to change their order.
• Share widget—You can customize the text that appears in the body of the email that generates when users share by email.
• Table widget—You can show related data in a table. If a data source has related data, you can make related records appear in columns at the end of each sheet. Each record in the table displays a count of associated related records. Users with editing privileges can edit existing related records. If you connect the Table widget to a Map widget, features highlight on the map when you hover the pointer over them in the table. This hover highlight is yellow to differentiate it from the selection highlight. In the Select layers panel, you can turn on Display layers generated at run time to include layers added to the map at run time with widgets such as the Add Data widget. If you connect the Table widget to a Map widget and turn on Customize layers, you can click and drag layers to change their order. Additionally, you can align text to the start, center, or end of cells. You can wrap text. You can now choose whether to include the Show/hide columns tool in the widget toolbar.

Developer edition updates

• When using the zipApp() script for automated deployment,you will now receive a report in the event of a failure.
• When importing apps that utilize custom widgets from ArcGIS Enterprise, the developer edition now automatically loads these custom widgets into the builder. As a result, you will see them under the Custom section in the Insert widget pane, just like other custom widgets added to the developer edition. This functionality enables the developer edition to include and use custom widgets from ArcGIS Enterprise. Furthermore, you can download and deploy these apps with custom widgets from ArcGIS Enterprise.
• ArcGIS Enterprise users now have the option to restrict app resources to those hosted exclusively within their ArcGIS Enterprise environment when connected to the Developer Edition. This option is particularly useful in disconnected environments, as it prevents navigation to ArcGIS.com when adding data to the app.
• When downloading developer edition apps, you can not only choose specific language files but also select all available language files with a single click. If the language files are unavailable for your browser set to a specific language, English will be used as the default language.
• A new Message component has been added to Storybook, which can be used to display a notification message globally.
• The following new samples are available:
  • Dock is a layout widget that allows users to create flexible layouts by adding, removing, and rearranging items.
  • Widget with layout shows how to use the layout provided by the experience builder. It is a simple widget with a fixed layout.

Breaking changes

jimu-ui

• Method componentStyleUtils is removed.

• Useless type InputProps, IconProps, TextWithIconProps, NavIconType and NavIcon are removed.

• Type ComponentSize is removed, use 'default' | 'sm' | 'lg' instead.

• MultiSelect

  • Prop items is deprecated, and item.render is removed, use MultiSelectItem component as children instead.
  • Type MultiSelectItem is removed (Now it is a component), use MultiSelectItemProps instead.
  • Prop onClickItem is deprecated, use onChange instead.
  • Prop buttonProps is removed, Some of the props have been spread onto the root props:
    • innerRef has been renamed to buttonRef and moved to the root props.
    • arrow has been moved to the root props.
    • disabled has been moved to the root props.
  • Prop menuItemProps is removed, use the props of the MultiSelectItem component in children instead.
  • Useless prop menuProps is removed.
  • Useless prop fluid is removed.
  • Useless prop autoWidth is removed.
  • Useless prop zIndex is removed.
  • Supports both controlled and uncontrolled modes:
    • If the initial values is undefined, it acts as an uncontrolled component.
    • Otherwise, it functions as a controlled component.

• ScrollList

  • Prop autoArrow is removed, and the arrows can be automatically displayed and hidden according to different scenarios.
  • Prop items is deprecated, use children instead.

• Toast

  • The Toast component is removed, use the Message component instead.

• TagInput

  • Prop data is deprecated, use values instead.
  • Prop selectListData is deprecated, use suggestions instead.

• Tag

  • The Tag component cannot be used alone, so it has been removed. Please use the TagInput component directly.

• Card

  • Prop button is renamed to clickable.
  • Useless prop horizontal is removed.

• CardImg

  • Unused CardImg and CardImgProps components are removed, use the Image component instead.

• Image

  • Useless prop type is removed.
  • Useless prop cover is removed.
  • Useless prop placeholder is removed.

• FormText

  • Useless component FormText is removed.

• InputGroupText

  • Useless component InputGroupText is removed.

• InputGroup

  • Useless props size is removed.

• ListGroupItem

  • Useless props color is removed.

• ListGroup

  • Useless props flush is removed.

• Table

  • Useless props striped is removed.
  • Useless props dark is removed.
  • Useless props borderless is removed.

• AdvancedSelect

  • Prop buttonProps is removed, Some of the props have been spread onto the root props:
    • icon has been moved to the root props.
    • arrow has been moved to the root props.
    • disabled has been moved to the root props.
  • Useless prop menuProps is removed.
    • hideOptions of menuProps has been moved to the root props.
  • Useless prop fluid is removed.
  • sortValuesByLabel is deprecated, use sortList instead.

• SketchStandardButton

  • Useless component SketchStandardButton is removed, it can be replaced by a combination of Sketch component and Button component.

• Link

  • Useless prop active is removed.
  • Useless prop htmlType is removed.
  • Useless prop themeStyle is removed.
  • Prop innerRef is removed, use ref instead.

• jimu-ui/basic/color-picker

  • ColorPicker
    • Prop text is renamed to noBackground.
  • ThemeColorPicker
    • Prop text is renamed to noBackground.

• jimu-ui/basic/date-picker

  • DatePicker
    • Prop isTimeLong is renamed to isLongTime.

• jimu-ui/advanced/map

  • The following map tools are deprecated: Locate, BaseMap, Measure, FullScreen, ScaleBar and Select. Please use map components instead.

jimu-core

• The enum type LoadingType is removed, use it from jimu-ui instead.
• SessionManager
  • addFromArcGisJSCredential is renamed to addFromCredential
• IMThemeVariables
  • The deprecated method getPalette is removed, use theme.colors.palette instead.
  • The deprecated method getOrgShareColors is removed, use variables in theme.mixin.sharedTheme instead.
• Manifest property requireEnterprise is replaced by requireLicense.

jimu-arcgis

• JimuMapView
  • Previously, when JimuMapView.whenJimuLayerViewLoaded() resolves, it will ensure that all descendant JimuLayerViews are loaded, which may cause performance problems. Now when JimuMapView.whenJimuLayerViewLoaded() resolves, descendant JimuLayerViews may not be loaded yet.

Previous releases

• Version 1.17 March 2025
• Version 1.16 December 2024
• Version 1.15 July 2024
• Version 1.14 March 2024
• Version 1.13 November 2023
• Version 1.12 July 2023
• Version 1.11 March 2023
• Version 1.10 November 2022
• Version 1.9 June 2022
• Version 1.8 April 2022
• Version 1.7 January 2022
• Version 1.6 October 2021
• Version 1.5 July 2021
• Version 1.4 May 2021
• Version 1.3 January 2021
• Version 1.2 November 2020
• Version 1.1 July 2020