plotly · camdecoster · Aug 8, 2025 · Aug 7, 2025 · Aug 7, 2025 · Aug 7, 2025
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -9,6 +9,38 @@ 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.1.0]
+
+### Added
+- Add property `zerolinelayer` to cartesian axes to allow drawing zeroline above traces [[#7269](https://github.com/plotly/plotly.js/pull/7269)]
+- Add `pattern.path` attribute as an alternative to the preset `pattern.shape` values, so you can use any SVG path string as a pattern fill. [[#7280](https://github.com/plotly/plotly.js/pull/7280)]
+- Allow configuration of horizontal legend max height [[#7359](https://github.com/plotly/plotly.js/pull/7359)]
+- Add `modebardisable` attribute to cartesian axes, to allow fine control over which buttons affect which axes [[#7358](https://github.com/plotly/plotly.js/pull/7358)]
+- Add support for ticklabelposition "inside"/"outside" for category axes with `tickson` set to "boundaries" [[#7420](https://github.com/plotly/plotly.js/pull/7420)],
+with thanks to @my-tien for the contribution!
+- Add `unifiedhovertitle.text` to format unified hover titles [[#7439](https://github.com/plotly/plotly.js/pull/7439)]
+- Add `layout.hoverlabel.showarrow` (and `trace.hoverlabel.showarrow`) attribute to allow hiding the triangular caret that appears on the hover label box [[#7451](https://github.com/plotly/plotly.js/pull/7451)]
+- Add `minorloglabels` to cartesian axes [[#7468](https://github.com/plotly/plotly.js/pull/7468)]
+- Make modebar keyboard-accessible via tabbing [[#7492](https://github.com/plotly/plotly.js/pull/7492)], with thanks to @davidangarita1 for the contribution!
+
+### Changed
+- Switch to United Nations (coastlines, countries, land, ocean) + Natural Earth (lakes, rivers, subunits) geodata for building topojson used in geo plot [[#7393](https://github.com/plotly/plotly.js/pull/7393)]
+- Make 'png' all caps [[#7400](https://github.com/plotly/plotly.js/pull/7400)]
+- Refactor files related to UN topojson [[#7481](https://github.com/plotly/plotly.js/pull/7481)]
+- Update default `topojsonURL` to point to new UN topojson [[#7514](https://github.com/plotly/plotly.js/pull/7514)]
+- Add breaking change warning for *country names* `locationmode` option in choropleth, scattergeo plots [[#7514](https://github.com/plotly/plotly.js/pull/7514)]
+
+### Fixed
+- Fix performance warning in scattergl traces, [[#7390](https://github.com/plotly/plotly.js/pull/7390)], with thanks to @MzyzzG for the contribution!
+- Move css-loader and other dependencies into devDependencies section [[#7407](https://github.com/plotly/plotly.js/pull/7407)]
+- Fix hidden ticklabels taking up plot space [[#7417](https://github.com/plotly/plotly.js/pull/7417)]
+- Fix editable shapes (regression introduced in 2.34.0) [[#7470](https://github.com/plotly/plotly.js/pull/7470)],
+  with thanks to @my-tien for the contribution!
+- Update legend maxheight calculation logic [[#7483](https://github.com/plotly/plotly.js/pull/7483)] 
+- Fix hover event not triggered on consecutive empty bins (count=0) with `hovermode:'x'` for histogram [[#7503](https://github.com/plotly/plotly.js/pull/7503)], with thanks to @Lexachoc for the contribution!
+- Remove **form-data** nested dependency associated with [CVE-2025-7783](https://github.com/advisories/GHSA-fjxv-7rqg-78g4) [[#7514](https://github.com/plotly/plotly.js/pull/7514)], with thanks to @KyleBoyer for the contribution!
+
+
 ## [3.1.0-rc.1] -- 2025-08-01
 
 ### 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.1.0-rc.1
+version: 3.1.0
 doi: 10.5281/zenodo.13964707
-date-released: 2025-08-01
+date-released: 2025-08-07
 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.1.0-rc.1.min.js" charset="utf-8"></script>
+    <script src="https://cdn.plot.ly/plotly-3.1.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.1.0-rc.1.min.js"
+    import "https://cdn.plot.ly/plotly-3.1.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.1.0-rc.1.js" charset="utf-8"></script>
+<script src="https://cdn.plot.ly/plotly-3.1.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.6 MB | 4.5 MB | 1.4 MB | 10.9 MB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-3.1.0-rc.1.js
+> https://cdn.plot.ly/plotly-3.1.0.js
 
-> https://cdn.plot.ly/plotly-3.1.0-rc.1.min.js
+> https://cdn.plot.ly/plotly-3.1.0.min.js
 
 
 #### npm packages
@@ -94,9 +94,9 @@ The `basic` partial bundle contains trace modules `bar`, `pie` and `scatter`.
 | 2.6 MB | 1012.1 kB | 350.6 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-basic-3.1.0-rc.1.js
+> https://cdn.plot.ly/plotly-basic-3.1.0.js
 
-> https://cdn.plot.ly/plotly-basic-3.1.0-rc.1.min.js
+> https://cdn.plot.ly/plotly-basic-3.1.0.min.js
 
 
 #### npm packages
@@ -117,9 +117,9 @@ The `cartesian` partial bundle contains trace modules `bar`, `box`, `contour`, `
 | 3.3 MB | 1.3 MB | 448.2 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-cartesian-3.1.0-rc.1.js
+> https://cdn.plot.ly/plotly-cartesian-3.1.0.js
 
-> https://cdn.plot.ly/plotly-cartesian-3.1.0-rc.1.min.js
+> https://cdn.plot.ly/plotly-cartesian-3.1.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 |
 |------|-----------------|------------------------|
-| 2.9 MB | 1.1 MB | 399.8 kB |
+| 2.9 MB | 1.1 MB | 400.1 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-geo-3.1.0-rc.1.js
+> https://cdn.plot.ly/plotly-geo-3.1.0.js
 
-> https://cdn.plot.ly/plotly-geo-3.1.0-rc.1.min.js
+> https://cdn.plot.ly/plotly-geo-3.1.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.1 MB | 1.5 MB | 514.6 kB |
+| 4.1 MB | 1.5 MB | 514.7 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-gl3d-3.1.0-rc.1.js
+> https://cdn.plot.ly/plotly-gl3d-3.1.0.js
 
-> https://cdn.plot.ly/plotly-gl3d-3.1.0-rc.1.min.js
+> https://cdn.plot.ly/plotly-gl3d-3.1.0.min.js
 
 
 #### npm packages
@@ -186,9 +186,9 @@ The `gl2d` partial bundle contains trace modules `parcoords`, `scatter`, `scatte
 | 3.7 MB | 1.4 MB | 507 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-gl2d-3.1.0-rc.1.js
+> https://cdn.plot.ly/plotly-gl2d-3.1.0.js
 
-> https://cdn.plot.ly/plotly-gl2d-3.1.0-rc.1.min.js
+> https://cdn.plot.ly/plotly-gl2d-3.1.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.4 MB | 1.8 MB | 565.6 kB |
+| 4.4 MB | 1.8 MB | 565.7 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-mapbox-3.1.0-rc.1.js
+> https://cdn.plot.ly/plotly-mapbox-3.1.0.js
 
-> https://cdn.plot.ly/plotly-mapbox-3.1.0-rc.1.min.js
+> https://cdn.plot.ly/plotly-mapbox-3.1.0.min.js
 
 
 #### npm packages
@@ -232,9 +232,9 @@ The `finance` partial bundle contains trace modules `bar`, `candlestick`, `funne
 | 2.8 MB | 1.1 MB | 384.2 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-finance-3.1.0-rc.1.js
+> https://cdn.plot.ly/plotly-finance-3.1.0.js
 
-> https://cdn.plot.ly/plotly-finance-3.1.0-rc.1.min.js
+> https://cdn.plot.ly/plotly-finance-3.1.0.min.js
 
 
 #### npm packages
@@ -255,9 +255,9 @@ The `strict` partial bundle contains trace modules `bar`, `barpolar`, `box`, `ca
 | 11.4 MB | 4.9 MB | 1.5 MB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-strict-3.1.0-rc.1.js
+> https://cdn.plot.ly/plotly-strict-3.1.0.js
 
-> https://cdn.plot.ly/plotly-strict-3.1.0-rc.1.min.js
+> https://cdn.plot.ly/plotly-strict-3.1.0.min.js
 
 
 #### npm packages