plotly · emilykl · Apr 3, 2026 · Apr 3, 2026 · Apr 3, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -9,6 +9,14 @@ To see all merged commits on the master branch that will be part of the next plo
 
 where X.Y.Z is the semver of most recent plotly.js release.
 
+## [3.5.0] -- 2026-04-03
+
+### Added
+ - Add `hoveranywhere` and `clickanywhere` layout attributes to emit hover and click events anywhere in the plot area, not just over traces [[#7707](https://github.com/plotly/plotly.js/pull/7707)]
+ - Add `displayNotifier` configuration property to set the display of notifier in the top right area of the viewport [[#7730](https://github.com/plotly/plotly.js/pull/7730)], with thanks to @silversonicaxel for the contribution!
+- Update USA location lookup for `scattergeo` and `choropleth` traces to use both location names and abbreviations [[7731](https://github.com/plotly/plotly.js/pull/7731)]
+
+
 ## [3.4.0] -- 2026-02-20
 
 ### Added

diff --git a/CITATION.cff b/CITATION.cff
@@ -9,7 +9,7 @@ authors:
 - family-names: "Samimi"
   given-names: "Mojtaba"
 title: "Open source Plotly charting library"
-version: 3.4.0
+version: 3.5.0
 doi: 10.5281/zenodo.13964707
-date-released: 2026-02-20
+date-released: 2026-04-03
 url: "https://github.com/plotly/plotly.js"
diff --git a/README.md b/README.md
@@ -62,7 +62,7 @@ You may also consider using [`plotly.js-dist`](https://www.npmjs.com/package/plo
 
 ```html
 <head>
-    <script src="https://cdn.plot.ly/plotly-3.4.0.min.js" charset="utf-8"></script>
+    <script src="https://cdn.plot.ly/plotly-3.5.0.min.js" charset="utf-8"></script>
 </head>
 <body>
     <div id="gd"></div>
@@ -79,7 +79,7 @@ You may also consider using [`plotly.js-dist`](https://www.npmjs.com/package/plo
 Alternatively, you may consider using [native ES6 import](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules) in the script tag.
 ```html
 <script type="module">
-    import "https://cdn.plot.ly/plotly-3.4.0.min.js"
+    import "https://cdn.plot.ly/plotly-3.5.0.min.js"
     Plotly.newPlot("gd", [{ y: [1, 2, 3] }])
 </script>
 ```
@@ -89,7 +89,7 @@ Fastly supports Plotly.js with free CDN service. Read more at <https://www.fastl
 ### Un-minified versions are also available on CDN
 While non-minified source files may contain characters outside UTF-8, it is recommended that you specify the `charset` when loading those bundles.
 ```html
-<script src="https://cdn.plot.ly/plotly-3.4.0.js" charset="utf-8"></script>
+<script src="https://cdn.plot.ly/plotly-3.5.0.js" charset="utf-8"></script>
 ```
 
 > Please note that as of v2 the "plotly-latest" outputs (e.g. https://cdn.plot.ly/plotly-latest.min.js) will no longer be updated on the CDN, and will stay at the last v1 patch v1.58.5. Therefore, to use the CDN with plotly.js v2 and higher, you must specify an exact plotly.js version.

diff --git a/dist/README.md b/dist/README.md
@@ -46,9 +46,9 @@ The main plotly.js bundles weight in at:
 | 10.7 MB | 4.6 MB | 1.4 MB | 11 MB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-3.4.0.js
+> https://cdn.plot.ly/plotly-3.5.0.js
 
-> https://cdn.plot.ly/plotly-3.4.0.min.js
+> https://cdn.plot.ly/plotly-3.5.0.min.js
 
 
 #### npm packages
@@ -91,12 +91,12 @@ The `basic` partial bundle contains trace modules `bar`, `pie` and `scatter`.
 
 | Raw size | Minified size | Minified + gzip size |
 |------|-----------------|------------------------|
-| 2.7 MB | 1.1 MB | 364.6 kB |
+| 2.7 MB | 1.1 MB | 364.8 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-basic-3.4.0.js
+> https://cdn.plot.ly/plotly-basic-3.5.0.js
 
-> https://cdn.plot.ly/plotly-basic-3.4.0.min.js
+> https://cdn.plot.ly/plotly-basic-3.5.0.min.js
 
 
 #### npm packages
@@ -114,12 +114,12 @@ The `cartesian` partial bundle contains trace modules `bar`, `box`, `contour`, `
 
 | Raw size | Minified size | Minified + gzip size |
 |------|-----------------|------------------------|
-| 3.4 MB | 1.4 MB | 462.8 kB |
+| 3.4 MB | 1.4 MB | 463 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-cartesian-3.4.0.js
+> https://cdn.plot.ly/plotly-cartesian-3.5.0.js
 
-> https://cdn.plot.ly/plotly-cartesian-3.4.0.min.js
+> https://cdn.plot.ly/plotly-cartesian-3.5.0.min.js
 
 
 #### npm packages
@@ -137,12 +137,12 @@ The `geo` partial bundle contains trace modules `choropleth`, `scatter` and `sca
 
 | Raw size | Minified size | Minified + gzip size |
 |------|-----------------|------------------------|
-| 3 MB | 1.2 MB | 414.2 kB |
+| 3 MB | 1.2 MB | 415.2 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-geo-3.4.0.js
+> https://cdn.plot.ly/plotly-geo-3.5.0.js
 
-> https://cdn.plot.ly/plotly-geo-3.4.0.min.js
+> https://cdn.plot.ly/plotly-geo-3.5.0.min.js
 
 
 #### npm packages
@@ -160,12 +160,12 @@ The `gl3d` partial bundle contains trace modules `cone`, `isosurface`, `mesh3d`,
 
 | Raw size | Minified size | Minified + gzip size |
 |------|-----------------|------------------------|
-| 4.2 MB | 1.6 MB | 532.4 kB |
+| 4.2 MB | 1.6 MB | 527.4 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-gl3d-3.4.0.js
+> https://cdn.plot.ly/plotly-gl3d-3.5.0.js
 
-> https://cdn.plot.ly/plotly-gl3d-3.4.0.min.js
+> https://cdn.plot.ly/plotly-gl3d-3.5.0.min.js
 
 
 #### npm packages
@@ -183,12 +183,12 @@ The `gl2d` partial bundle contains trace modules `parcoords`, `scatter`, `scatte
 
 | Raw size | Minified size | Minified + gzip size |
 |------|-----------------|------------------------|
-| 3.8 MB | 1.5 MB | 520.8 kB |
+| 3.8 MB | 1.5 MB | 521.2 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-gl2d-3.4.0.js
+> https://cdn.plot.ly/plotly-gl2d-3.5.0.js
 
-> https://cdn.plot.ly/plotly-gl2d-3.4.0.min.js
+> https://cdn.plot.ly/plotly-gl2d-3.5.0.min.js
 
 
 #### npm packages
@@ -206,12 +206,12 @@ The `mapbox` partial bundle contains trace modules `choroplethmapbox`, `densitym
 
 | Raw size | Minified size | Minified + gzip size |
 |------|-----------------|------------------------|
-| 4.5 MB | 1.9 MB | 579.3 kB |
+| 4.5 MB | 1.9 MB | 580.1 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-mapbox-3.4.0.js
+> https://cdn.plot.ly/plotly-mapbox-3.5.0.js
 
-> https://cdn.plot.ly/plotly-mapbox-3.4.0.min.js
+> https://cdn.plot.ly/plotly-mapbox-3.5.0.min.js
 
 
 #### npm packages
@@ -229,12 +229,12 @@ The `finance` partial bundle contains trace modules `bar`, `candlestick`, `funne
 
 | Raw size | Minified size | Minified + gzip size |
 |------|-----------------|------------------------|
-| 2.9 MB | 1.2 MB | 398.2 kB |
+| 2.9 MB | 1.2 MB | 398.5 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-finance-3.4.0.js
+> https://cdn.plot.ly/plotly-finance-3.5.0.js
 
-> https://cdn.plot.ly/plotly-finance-3.4.0.min.js
+> https://cdn.plot.ly/plotly-finance-3.5.0.min.js
 
 
 #### npm packages
@@ -252,12 +252,12 @@ The `strict` partial bundle contains trace modules `bar`, `barpolar`, `box`, `ca
 
 | Raw size | Minified size | Minified + gzip size |
 |------|-----------------|------------------------|
-| 11.5 MB | 5 MB | 1.5 MB |
+| 11.5 MB | 4.9 MB | 1.5 MB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-strict-3.4.0.js
+> https://cdn.plot.ly/plotly-strict-3.5.0.js
 
-> https://cdn.plot.ly/plotly-strict-3.4.0.min.js
+> https://cdn.plot.ly/plotly-strict-3.5.0.min.js
 
 
 #### npm packages

diff --git a/dist/plot-schema.json b/dist/plot-schema.json
@@ -124,6 +124,11 @@
         false
       ]
     },
+    "displayNotifier": {
+      "description": "Determines whether or not notifier is displayed.",
+      "dflt": true,
+      "valType": "boolean"
+    },
     "doubleClick": {
       "description": "Sets the double click interaction mode. Has an effect only in cartesian plots. If *false*, double click is disable. If *reset*, double click resets the axis ranges to their initial values. If *autosize*, double click set the axis ranges to their autorange values. If *reset+autosize*, the odd double clicks resets the axis ranges to their initial values and even double clicks set the axis ranges to their autorange values.",
       "dflt": "reset+autosize",
@@ -1166,6 +1171,12 @@
           "ummalqura"
         ]
       },
+      "clickanywhere": {
+        "description": "If true, `plotly_click` events will fire for any click position within the plot area, not just over traces. When clicking where there is no trace data, the event will have an empty `points` array but will include `xvals` and `yvals` with click coordinates in data space.",
+        "dflt": false,
+        "editType": "none",
+        "valType": "boolean"
+      },
       "clickmode": {
         "description": "Determines the mode of single click interactions. *event* is the default value and emits the `plotly_click` event. In addition this mode emits the `plotly_selected` event in drag modes *lasso* and *select*, but with no event data attached (kept for compatibility reasons). The *select* flag enables selecting single data points via click. This mode also supports persistent selections, meaning that pressing Shift while clicking, adds to / subtracts from an existing selection. *select* with `hovermode`: *x* can be confusing, consider explicitly setting `hovermode`: *closest* when using this feature. Selection events are sent accordingly as long as *event* flag is set as well. When the *event* flag is missing, `plotly_click` and `plotly_selected` events are not fired.",
         "dflt": "event",
@@ -2807,6 +2818,12 @@
         "editType": "plot",
         "valType": "boolean"
       },
+      "hoveranywhere": {
+        "description": "If true, `plotly_hover` events will fire for any cursor position within the plot area, not just over traces. When the cursor is not over a trace, the event will have an empty `points` array but will include `xvals` and `yvals` with cursor coordinates in data space.",
+        "dflt": false,
+        "editType": "none",
+        "valType": "boolean"
+      },
       "hoverdistance": {
         "description": "Sets the default distance (in pixels) to look for data to add hover labels (-1 means no cutoff, 0 means no looking for data). This is only a real distance for hovering on point-like objects, like scatter points. For area-like objects (bars, scatter fills, etc) hovering is on inside the area and off outside, but these objects will not supersede hover on point-like objects in case of conflict.",
         "dflt": 20,
@@ -25447,7 +25464,7 @@
           "valType": "number"
         },
         "locationmode": {
-          "description": "The library used by the *country names* `locationmode` option is changing in an upcoming version. Country names in existing plots may not work in the new version. Determines the set of locations used to match entries in `locations` to regions on the map. Values *ISO-3*, *USA-states*, *country names* correspond to features on the base map and value *geojson-id* corresponds to features from a custom GeoJSON linked to the `geojson` attribute.",
+          "description": "The library used by the *country names* `locationmode` option is changing in an upcoming version. Country names in existing plots may not work in the new version. Determines the set of locations used to match entries in `locations` to regions on the map. Values *ISO-3*, *USA-states*, *country names* correspond to features on the base map and value *geojson-id* corresponds to features from a custom GeoJSON linked to the `geojson` attribute. *USA-states* accepts both two-letter abbreviations (e.g. *CA*) and full state names (e.g. *California*).",
           "dflt": "ISO-3",
           "editType": "calc",
           "valType": "enumerated",
@@ -67366,7 +67383,7 @@
           }
         },
         "locationmode": {
-          "description": "The library used by the *country names* `locationmode` option is changing in an upcoming version. Country names in existing plots may not work in the new version. Determines the set of locations used to match entries in `locations` to regions on the map. Values *ISO-3*, *USA-states*, *country names* correspond to features on the base map and value *geojson-id* corresponds to features from a custom GeoJSON linked to the `geojson` attribute.",
+          "description": "The library used by the *country names* `locationmode` option is changing in an upcoming version. Country names in existing plots may not work in the new version. Determines the set of locations used to match entries in `locations` to regions on the map. Values *ISO-3*, *USA-states*, *country names* correspond to features on the base map and value *geojson-id* corresponds to features from a custom GeoJSON linked to the `geojson` attribute. *USA-states* accepts both two-letter abbreviations (e.g. *CA*) and full state names (e.g. *California*).",
           "dflt": "ISO-3",
           "editType": "calc",
           "valType": "enumerated",

diff --git a/dist/plotly-basic.js b/dist/plotly-basic.js
diff --git a/dist/plotly-basic.min.js b/dist/plotly-basic.min.js
diff --git a/dist/plotly-cartesian.js b/dist/plotly-cartesian.js
diff --git a/dist/plotly-cartesian.min.js b/dist/plotly-cartesian.min.js
diff --git a/dist/plotly-finance.js b/dist/plotly-finance.js
diff --git a/dist/plotly-finance.min.js b/dist/plotly-finance.min.js
diff --git a/dist/plotly-geo-assets.js b/dist/plotly-geo-assets.js
diff --git a/dist/plotly-geo.js b/dist/plotly-geo.js
diff --git a/dist/plotly-geo.min.js b/dist/plotly-geo.min.js
diff --git a/dist/plotly-gl2d.js b/dist/plotly-gl2d.js
diff --git a/dist/plotly-gl2d.min.js b/dist/plotly-gl2d.min.js
diff --git a/dist/plotly-gl3d.js b/dist/plotly-gl3d.js
diff --git a/dist/plotly-gl3d.min.js b/dist/plotly-gl3d.min.js
diff --git a/dist/plotly-mapbox.js b/dist/plotly-mapbox.js