ArcGIS Blog

Announcements

ArcGIS Experience Builder

Feb 20, 2026

Migrating ArcGIS Experience Builder Custom Widgets to Web Components

By Jianxia Song and Sarah Jane O’Keefe

The ArcGIS Maps SDK for JavaScript widgets will be retired by Q1 2027. If you have custom widgets in ArcGIS Experience Builder that use these JavaScript widgets, you need to act.

To make sure your custom widgets keep working with future updates, it’s important that you rebuild or migrate them to use the ArcGIS Maps SDK for JavaScript web components. This will help avoid interruptions when new versions are released.

Why is this happening?

Esri is building standards-based web components in ArcGIS Maps SDK for JavaScript. The recommended approach is to use web components other than widgets from JavaScript Maps SDK. This shift in JavaScript Maps SDK architecture maximizes productivity of front-end web development. For more information, see the Transition Plan.

Who will be affected? 

This migration requirement only applies to ArcGIS Experience Builder custom widgets that build on ArcGIS Maps SDK for JavaScript widgets. If your custom widgets do not depend on JavaScript widgets, no action is needed.

What happens if affected widgets aren’t migrated?

Custom widgets built with the deprecated JavaScript widgets will stop working when:

  • You upgrade to ArcGIS Experience Builder Developer Edition released in Q1 2027 or later, which uses web components.
  • You add custom widgets to ArcGIS Enterprise released in the first half of 2027 or later, where Experience Builder runs on a web component-based SDK.

See the About Release Versions page for details.

What should I do now?

  • Migrate existing custom widgets to use JavaScript Maps SDK web components by Q1 2027.
  • Build new custom widgets using web components starting now.

Will out-of-the-box widgets migrate?  

By the first quarter of 2027, the out-of-the-box widgets in ArcGIS Experience Builder—such as Basemap Gallery, Swipe, Map Layers, and more—that build on JavaScript Maps SDK widgets will be migrated to use web components.

When should I start?

Don’t wait for the migration of out-of-the-box widgets. If the counterpart JavaScript Maps SDK web components are available, start your migration immediately. Additionally, ArcGIS Experience Builder Developer Edition v1.19 or later uses React 19 with full web component support.

What’s the timeline?  

  • Deprecation of JavaScript Maps SDK widgets: Q1 2026
  • Retirement from SDK: As early as Q1 2027

Resources

To future-proof your ArcGIS Experience Builder custom widgets before the 2027 retirement of JavaScript Maps SDK widgets, start migrating them to web components.

Blogs:

Samples & Tutorials:

Documentation:

 

Share this article

announcements arcgis experience builder arcgis experience builder developer edition arcgis maps sdk for javascript custom widgets web components arcgis experience builder
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.

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.

Article Discussion:

Leave a Reply

Related articles