ArcGIS Blog

Announcements

Apps

Apr 08, 2026

Retirement of custom widgets in ArcGIS Experience Builder built with Maps SDK for JavaScript

By Sarah Jane O’Keefe and Jianxia Song

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

 

I built custom widgets using Maps SDK for JavaScript. Do I need to do anything? 

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

 

When will these custom widgets stop working? 

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

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

For more information, see the About Release Versions webpage.

 

What do I need to do?

Developers should migrate these custom widgets to JavaScript Maps SDK components by Q1 2027 to ensure continued functionality.

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

 

Will out-of-the box widgets be affected?

  • Out-of-the-box ArcGIS Experience Builder widgets (e.g., Basemap Gallery, Swipe, Map, Map Layers, 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 should 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.

 

Where can I learn more?

Share this article

announcements developers arcgis arcgis experience builder arcgis maps sdk for javascript retirement apps arcgis experience builder arcgis maps sdk for javascript developers
Sarah Jane O’Keefe

As a strategic content leader and brand storytelling expert, Sarah Jane's work has spanned architecture, techology, automotive, international travel, utilities, and more. She is drawn to GIS by a personal passion for environmental science and climate change mitigation.

Jianxia Song

Product Manager for ArcGIS Experience Builder and ArcGIS Web AppBuilder. With over 20 years at Esri, she has contributed to a wide range of products, spanning from desktop applications to web-based solutions, and from developer-focused technologies to no-code app builders. Her extensive experience reflects a deep understanding of both technical and user-centric perspectives in products. Outside of work, she enjoys hiking and camping, embracing the outdoors with the same passion she brings to her professional endeavors.

Article Discussion:

Leave a Reply

Related articles