ArcGIS Maps SDK for JavaScript – Version 4.33 Release
Version 4.33 is here, it’s there, it’s everywhere. There are enhancements, bug fixes, and new functionality. By the numbers: we fixed 37 bugs, made 9 enhancements, added or updated 12 samples, optimized 8 components, and added 3 brand new components.
Now, we’re going to do something different this time. We installed two long awaited enhancements at version 4.33. They are important, but they also are straight-forward and easy to explain. So, they’ll go first, and then we will proceed with our regularly scheduled Esri Community release blog.
Multipoint labeling
Multipoint labeling is here. Multipoint geometry represents a collection of single locations in space, and can be used to represent geographical features that have multiple single locations but also represent a single geographical feature. For example, the multiple entrances to a football stadium. This can apply to both football and soccer, because it’s nice to be inclusive.
4.33 Multipart Labeling example
https://codepen.io/noash/pen/GgJBMBe?editors=1000
Directions printing (beta)
The Directions component (and widget) now offer printed directions in beta. Additional printing functionality and enhancements are planned for future releases. This is available in the options (three little dots) of a completed route. You can disable printing by setting the new printButton property on VisibleElements.
Components I
We updated the CDN endpoint for components. The old endpoint will still work for 4.33, but will be removed at 4.34. We did this to make the URL more consistent with the core API.
The viewOnReady method on the Map, Scene, and Link Chart components allows you to wait until the component's internal view is fully initialized and ready to be used.
Lastly, components properties are now watchable with reactiveUtils, the same utility used to observe changes in core API properties.
https://developers.arcgis.com/javascript/latest/watch-for-changes/ - component-readiness-and-events
Also, if you’re new or newish to components, this is really good timing because we also just released the recorded sessions from the 2025 Esri Dev & Technology Summit, and there is an incredible 3-part series available about components that you can binge watch now. It’s free.
App Development with Components Part 1: Core Patterns
Esri Dev & Technology Summit – March 2025
https://mediaspace.esri.com/playlist/dedicated/368599242/1_v7vsqnff/1_ibocnx9i
App Development with Components Part 2: Using Frameworks
Esri Dev & Technology Summit – March 2025
https://mediaspace.esri.com/playlist/dedicated/368599242/1_v7vsqnff/1_v4cmupss
App Development with Components Part 3: User Experience
Esri Dev & Technology Summit – March 2025
https://mediaspace.esri.com/playlist/dedicated/368599242/1_v7vsqnff/1_qtxjxkh4
Modern imports
The new $arcgis.import() global function is a modern replacement for AMD require when building apps via CDN.
https://developers.arcgis.com/javascript/latest/release-notes/#modernize-with-arcgisimport
Fresh batch of editing (e.g. Batch editing)
A batch is like a group, so batch editing is doing an add/update/delete operation on multiple features at once. Ditto for selecting features, and the selected features can be easily viewed, refined, and managed. There are additional constraints and more information available in the release notes.
https://developers.arcgis.com/javascript/latest/release-notes/#batch-editing
Focus area
Focus areas highlight and focus the viewer’s attention to a certain part of their scene. Two predefined styles, dark or bright, allow to choose a visualization with good contrasts for scenes with different coloring.
https://developers.arcgis.com/javascript/latest/sample-code/focus-area/
Oriented to imagery
The Oriented Imagery Viewer now includes triangulated measurement tools, enabling users to calculate distance, area, and location by intersecting vectors from measurement points captured from two different viewpoints. We also added tools for effortlessly transitioning between adjacent or sequential images, with Directional Navigation and Sequential Navigation. Read the release notes to get the full story.
https://developers.arcgis.com/javascript/latest/release-notes/#oriented-imagery
Search me
Search saw some love at 4.33. First, we updated the resulting popup with Calcite to make it more beautiful and helpful (e.g. shows number of additional results in the popup without having to expand now). And then we deprecated the Search widget to reveal the Search component! It’s so awesome now. We even updated a couple of samples to show-off the Search component in action:
4.33 Search component multisource sample
https://developers.arcgis.com/javascript/latest/sample-code/search-component-multisource/
4.33 Search component custom source sample
https://developers.arcgis.com/javascript/latest/sample-code/search-component-customsource/
3D Tiles with enhanced mesh
The IntegratedMesh3DTilesLayer now supports applying client-side modifications using the same SceneModifications class used by the I3S IntegratedMeshLayer. This enables you to focus on specific areas of a mesh, trim its outline, or replace a section with alternative 3D data.
https://developers.arcgis.com/javascript/latest/sample-code/layers-integratedmeshlayer-modification/
Layer-based scale ranges
Switch visibility seamlessly between different layer types based on the scale, now possible in 3D. Layer-based scale ranges toggle the visibility of the whole layer based on the scale of the view and can be used more efficiently to switch different representations in a scene.
https://developers.arcgis.com/javascript/latest/release-notes/#layer-based-scale-range
Did it print?
Printing also saw some love with a slew of bug fixes and enhancements. And then we deprecated the Print widget to reveal the Print component! It’s even awesomer now. Here’s a demo and custom sample that shows the Print component in action. And, for dessert, here’s a recording from the recent Dev & Technology Summit about printing as well.
4.33 print component demo
https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-print/#demo
4.33 print component sample
https://codepen.io/noash/pen/WbvKXKE?editors=1000
Printing for Web Developers – Esri Dev & Technology Summit – March 2025
https://mediaspace.esri.com/playlist/dedicated/368599242/1_v7vsqnff/1_ylqocqa5
Analyze this and that
We added a place() method to the 3D analysis views to allow interactive creation of all the analyses. This applies to the area measurement, direct line measurement, slice, line of sight, viewshed, and dimension 3D analysis views. The place() method can also be called directly on the respective layer views: line of sight, viewshed, and dimension.
https://developers.arcgis.com/javascript/latest/sample-code/analysis-objects/
Spike theme
We added a new 2D spike theme to the size renderer creator. This theme visualizes numeric data as spikes where the height of the spike corresponds to a value. This has nothing to do with spiking a football.
https://developers.arcgis.com/javascript/latest/release-notes/#smart-mapping-spike-theme
Persistence is not futile
MapImageLayers can now be saved either as a new item, or to update an existing item, within ArcGIS Online or ArcGIS Enterprise. The save() and saveAs() methods can be used to persist the layer's configuration.
https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-MapImageLayer.html - save
Developer & Technology Summit
Remember the 2025 Esri Developer & Technology Summit? It was so awesome. Now, you can experience it again (or for the first time) with these free videos from the plenary and technical sessions (demo theaters were not recorded).
Session Videos – March 2025
https://mediaspace.esri.com/channel/2025%2BEsri%2BDeveloper%2B%2526%2BTechnology%2BSummit/368599242
Plenary Videos – March 2025
JavaScript SDK Plenary Video – March 2025
https://mediaspace.esri.com/media/t/1_n60lcn7p/373383312
JavaScript
And if you’re new or newish to JavaScript, me and @Sage_Wall presented an introduction to JavaScript session recently, check it out:
An Introduction to JavaScript for Future Web Developers
https://mediaspace.esri.com/playlist/dedicated/368599242/1_v7vsqnff/1_sze8ojvh
And More
Act now and upgrade to version 4.33 today, and as a free gift, you’ll also receive:
Performance improvements
https://developers.arcgis.com/javascript/latest/release-notes/ - performance-improvements
More component updates
https://developers.arcgis.com/javascript/latest/release-notes/ - charts-components-beta
https://developers.arcgis.com/javascript/latest/release-notes/ - component-and-widget-updates
Utility Network updates
API Key updates
https://developers.arcgis.com/javascript/latest/release-notes/ - globally-configured-api-key-updates
And more!
https://developers.arcgis.com/javascript/latest/
Components II
Before we part ways, if you’re still reading this, remember components? And how we talked about the incredible 3-part mini-series? Well, if you’re into reading, we wanted to offer a list of recent blogs and documentation:
Build GIS Web Apps with JavaScript Maps SDK components (Blog – November 2023)
Build GIS Web Apps with JavaScript Maps SDK Components (Blog – Spring 2024)
https://www.esri.com/about/newsroom/arcuser/webcomponents
ArcGIS Map Components (Blog – June 2024)
https://odoe.net/blog/arcgis-map-components-release
JavaScript Maps SDK: A full transition to components (Blog – February 2025)
JavaScript Maps SDK Transitions to Web Components (Blog – Spring 2025)
https://www.esri.com/about/newsroom/arcuser/javascript-maps-sdk-transitions-to-web-components
Intro to Components (Documentation – June 2025)
https://developers.arcgis.com/javascript/latest/components/
Transition plan: widgets to components (Documentation – June 2025)
https://developers.arcgis.com/javascript/latest/components-transition-plan/
References
Release Blog
4.33 Release Notes
https://developers.arcgis.com/javascript/latest/guide/release-notes/index.html
4.33 Samples
https://developers.arcgis.com/javascript/latest/sample-code/?tagged=4.33
Breaking Changes across all 4x releases
https://developers.arcgis.com/javascript/latest/guide/breaking-changes/index.html
Multipoint Geometry
- https://help.arcgis.com/en/arcgisexplorer/900/ArcGISExplorer/sdk/html/35dfc14d-69fa-5748-1690-791140...
- https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Multipoint.html
- https://pro.arcgis.com/en/pro-app/3.3/sdk/api-reference/topic8538.html