DEPRECATION

ArcGIS Experience Builder custom widgets built with ArcGIS Maps SDK for JavaScript widgets

Last Published: February 11, 2026

Description

If you have built ArcGIS Experience Builder custom widgets using ArcGIS Maps SDK for JavaScript widgets, please note that these widgets  will retire in Q1 2027.  

Recommendation

With ArcGIS Maps SDK for JavaScript widgets being retired, developers must build or migrate ArcGIS Experience Builder custom widgets using ArcGIS Maps SDK for JavaScript web components to ensure future compatibility.

Experience Builder custom widgets built with JavaScript Maps SDK widgets will stop working when customers have:

  • upgraded to an ArcGIS Experience Builder version released in Q1 2027 or later that uses a JavaScript Maps SDK version with web components.
  • added custom widgets to ArcGIS Enterprise released in the first half of 2027 or later where Experience Builder is running a JavaScript Maps SDK version with web components.

For more information, refer to the About release versions webpage.

Developers must migrate these custom widgets to JavaScript Maps SDK components by Q1 2027 to ensure continued functionality, and:

  • immediately start building new custom widgets using JavaScript Maps SDK web components.
  • refactor existing custom widgets that rely on JavaScript Maps SDK widgets to web components.
Note: 
•  Out-of-the-box ArcGIS Experience Builder widgets (for example, Basemap Gallery, Swipe, Map, Map Layers, and Table) will be refactored to JavaScript Maps SDK web components in Q1 2027. Since the Experience Builder Framework and widgets may take more time to migrate, developers must start their migration now, as there is no technical barrier. (Out-of-the-box widgets will not be affected.)
•  ArcGIS Experience Builder v1.19 or later use React 19 with full web components support.

Article ID: 000040233

Software:
  • ArcGIS Maps SDK for JavaScript
  • ArcGIS Enterprise
  • ArcGIS Experience Builder Developer

Get help from ArcGIS experts

Contact technical support

Start chatting now

Go to download options