Getting started with widget development

ArcGIS Experience Builder is built with React and the ArcGIS API for JavaScript. It allows you to create custom widgets for your specific workflows. To create your own widgets, you will need a basic understanding of the following:

  • TypeScript is a superset of JavaScript. TypeScript is the language used to develop widgets.
  • React is a JavaScript library for creating user interfaces. React is an abstraction away from the DOM; it encourages you to think of your application and UI in various states and render those states to make it easy to keep your UI consistent.
  • JSX is a JavaScript extension syntax that allows you to describe what the widget's UI’s should look like through React.
  • Jimu is Experience Builder’s JavaScript library used to create widgets.


Experience Builder is available as a ZIP file for installation. For more details, please review the installation page.


A widget is a configurable and sharable functional unit in Experience Builder. Basically, a widget is a React component injected with these common properties by the jimu framework:

  • Configurations for widget, such as id, label, config, etc.
  • Runtime information about the widget including state, isClassLoaded, etc.
  • Local language strings
  • Data source instance and status information
  • URL parameter information

To get started quickly with the minimal set of files required, see the simple widget in the your-extensions\widgets folder.

For more details on widget development, learn about widget implementation.

Just the Basics

If you're brand new to Experience Builder development and want to understand the basic concepts, check out the following:

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.