Skip to content

chore: Release v4.0.0 #7987

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
camdecoster merged 2 commits into from
Aug 24, 2026
Merged

chore: Release v4.0.0 #7987

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
b9e8135
Updates for release v4.0.0
camdecoster Aug 24, 2026
e020cc0
4.0.0
camdecoster Aug 24, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
69 changes: 69 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,75 @@ 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.

## [X.Y.Z] -- UNRELEASED
Comment thread
emilykl marked this conversation as resolved.


## [4.0.0] -- 2026-08-24

### Added
- Add `minscale`, `maxscale` geo plot attributes [[#7371](https://github.com/plotly/plotly.js/pull/7371)], with thanks to @mojoaxel for the contribution!
- Enable TypeScript compatibility within the library and start exporting types [[#7680](https://github.com/plotly/plotly.js/pull/7680)]
- Add `quiver` trace type to visualize vector fields using arrows [[#7710](https://github.com/plotly/plotly.js/pull/7710), [#7945](https://github.com/plotly/plotly.js/issues/7945)], with thanks to @degzhaus for the contribution!
- Use dashed markers in legend for shape traces with dash configured [[#7845](https://github.com/plotly/plotly.js/pull/7845)]
- Add `direction` attribute to the Sankey trace, controlling the flow direction along the `orientation` axis [[#7870](https://github.com/plotly/plotly.js/pull/7870)], with thanks to @wf-r for the contribution!
- `forward` keeps sources on the left (horizontal) or top (vertical)
- `reversed` moves them to the right or bottom
- Add `sort` option to Sankey links and nodes [[#7873](https://github.com/plotly/plotly.js/pull/7873)], with thanks to @adamreeve for the contribution!
- Add support for MathJax v4 [[#7898](https://github.com/plotly/plotly.js/pull/7898)]
- Add top-level `xPixel` and `yPixel` keys to hover and click event data, corresponding to the pixel position of the cursor relative to the top-left corner of the graph div [[#7966](https://github.com/plotly/plotly.js/pull/7966)]
- When `hoveranywhere` is enabled, emit a `plotly_unhover` event when the cursor leaves the plot area [[#7966](https://github.com/plotly/plotly.js/pull/7966)]

### Removed
- **Breaking**: Remove `scattermapbox`, `choroplethmapbox`, `densitymapbox` trace types, the `mapbox` subplot, and the `mapboxAccessToken` config option [[#7860](https://github.com/plotly/plotly.js/pull/7860)]
- These traces have been deprecated since v3. Use the equivalent `*map` traces going forward.
- **Breaking**: Drop support for MathJax v2 [[#7898](https://github.com/plotly/plotly.js/pull/7898)]
- MathJax v3 and v4 are now supported in plotly.js
- Remove config attributes `showLink`, `linkText`, `sendData`, `showSources`, and `showEditInChartStudio`, as well as trace attribute `stream`, since all of these were associated with Chart Studio and are no longer needed [[#7812](https://github.com/plotly/plotly.js/pull/7812)]
- Remove all `*src` attributes, as well as `layout.hidesources` attribute, from the schema [[#7829](https://github.com/plotly/plotly.js/pull/7829)]
- Remove internal `trace._fullInput` property and other dead code related to the removed `transforms` feature. No user-facing changes expected [[#7834](https://github.com/plotly/plotly.js/pull/7834)]

### Changed
- **Breaking**: Switch color processing library from [TinyColor](https://github.com/bgrins/TinyColor) to [culori](https://culorijs.org) [[#7536](https://github.com/plotly/plotly.js/pull/7536)], [#7962](https://github.com/plotly/plotly.js/pull/7962)]
- `rgb()`/`rgba()` strings with decimal 0–1 fractions are no longer interpreted as percentage values (relative to 255)
- `hsv()` color strings are no longer permitted
- New color formats are now supported: `#ff0000aa`, `#f00a`, `rgb(255 0 0)`, `rgba(255 0 0 / 0.5)`, `hsl(0 100% 50% / 0.5)`, `hsla(0, 100%, 50%, 0.5)`, `lab()`, `lch()`, `oklab()`, `oklch()`, `color()`, `hsl(0.5turn 60% 40%)`, `hsl(none 60% 40%)`
- `rgb()` now accepts an optional alpha, so `rgb(255, 0, 0, 0.5)` is no longer opaque (`rgb` and `rgba` are aliases per [spec](https://www.w3.org/TR/css-color-4/#changes-from-3))
- Color strings that are not valid CSS are now rejected, such as `hsl(120, 50% 50%)`
- Contrasting text and border colors are picked by WCAG contrast ratio, so labels on saturated mid-tone fills may switch from dark to white
- **Breaking**: Set default `layout.axis.tickmode` to `'sync'` when axis is overlaying [[#7684](https://github.com/plotly/plotly.js/pull/7684)]
- **Breaking**: Change `splom.axis.matches` default from `false` to `true` [[#7843](https://github.com/plotly/plotly.js/pull/7843)]
- **Breaking**: Replace `country-regex` with `country-iso-search` to search for country names in choropleth, scattergeo traces [[#7856](https://github.com/plotly/plotly.js/pull/7856)]
- The vast majority of country names are handled exactly the same with the new library; a small number of legacy entries have been removed
- **Breaking**: Update minimum required Node version to 22 [[#7861](https://github.com/plotly/plotly.js/pull/7861)]
- **Breaking:** Change `layout.geo.fitbounds` default from `false` to `'locations'` [[#7895](https://github.com/plotly/plotly.js/pull/7895)]
- `geo` subplots will now auto-fit the initial view to the trace data
- Set `fitbounds: false` explicitly to opt out
- **Breaking**: Return actual data values (rather than calcdata values) for `xvals` / `yvals` in `hoveranywhere` and `clickanywhere` events. Date and category axes will now return strings rather than numeric values. Linear and log axis values remain unchanged. [[#7964](https://github.com/plotly/plotly.js/pull/7964)]
- Enable `scattermap` icons to render in color, upgrade Maki icons version to 8.2, and standardize scattermap legend icons to circles [[#7825](https://github.com/plotly/plotly.js/pull/7825)]
- Use plot title as default filename for "Download plot" button [[#7828](https://github.com/plotly/plotly.js/pull/7828)]
- Change signature of `plots.graphJson()` function to remove `mode` argument [[#7829](https://github.com/plotly/plotly.js/pull/7829)]
- Upgrade `plotly/d3-sankey` to 0.12.3. [[#7830](https://github.com/plotly/plotly.js/pull/7830)], with thanks to @adamreeve for the contribution!
- Update `plot_config` to show the "Upload to Cloud" button by default, and set the default server URL to cloud.plotly.com via [[#7909](https://github.com/plotly/plotly.js/pull/7909)]
- Update "Share chart" dialog with more informative wording [[#7928](https://github.com/plotly/plotly.js/pull/7928)]

### Fixed
- Fix `histogram` autobin size for single-point traces in `overlay` mode on data updates via `Plotly.react` [[#7507](https://github.com/plotly/plotly.js/pull/7507)], with thanks to @Lexachoc for the contribution!
- Format tick labels correctly for small numbers in exponential notation [[#7768](https://github.com/plotly/plotly.js/pull/7768)], with thanks to @Hasnaathussain for the contribution!
- Defer automargin during scroll-wheel zoom, to prevent erratic jittering while zooming [[#7815](https://github.com/plotly/plotly.js/pull/7815)], with thanks to @keilogic for the contribution!
- Fix crash when ordering categories by value (e.g. `sum descending`) with `null` coordinates [[#7855](https://github.com/plotly/plotly.js/pull/7855)]
- Prevent outside bar text for zero-length bars from overlapping axis tick labels [[#7872](https://github.com/plotly/plotly.js/pull/7872)], with thanks to @vizansh for the contribution!
- Fix `scattermap`, `densitymap` traces not showing all points by dynamically computing `center`, `zoom` values [[#7884](https://github.com/plotly/plotly.js/pull/7884), [#7913](https://github.com/plotly/plotly.js/pull/7913)], with thanks to @palmerusaf and @DhruvGarg111 for the contributions!
- Fix GeoJSON bounding-box computation for `choropleth` and `scattergeo` traces whose geometry crosses the antimeridian [[#7891](https://github.com/plotly/plotly.js/pull/7891)]
- Fix `hovertemplate`/`texttemplate`/`tickformat`/`hoverformat` improperly handling d3-format specs that start with a sign flag such as `+.2f` [[#7900](https://github.com/plotly/plotly.js/pull/7900)], with thanks to @TemRevil for the contribution!
- Snap cartesian axis tick values to multiple of delta so custom `tickformat` (e.g. `"~r"`) no longer shows floating-point artifacts [[#7901](https://github.com/plotly/plotly.js/pull/7901)], with thanks to @arieleli01212 and @kirthi-b for the contribution!
- Fix `scattermap` box and lasso selection across the antimeridian [[#7905](https://github.com/plotly/plotly.js/pull/7905)], with thanks to @coyaSONG for the contribution!
- Fix crash ("Something went wrong with axis scaling") when a colorbar's title or padding leaves it with a negative domain length [[#7908](https://github.com/plotly/plotly.js/pull/7908)], with thanks to @zeehio for the contribution!
- Prevent MultiPolygon features with no positive-area polygon from aborting choropleth rendering [[#7921](https://github.com/plotly/plotly.js/pull/7921)], with thanks to @swjturay for the contribution!
- Fix `geo.fitbounds: 'locations'` when mixing antimeridian-crossing territories with normal ones [[#7948](https://github.com/plotly/plotly.js/pull/7948)]
- Fix issue where plot fails to render if unsupported MathJax version is present on page [[#7951](https://github.com/plotly/plotly.js/pull/7951)]
- Fix numeric color sorting for bundled parallel-categories (parcats) paths [[#7959](https://github.com/plotly/plotly.js/pull/7959)], with thanks to @CAOShurong for the contribution!


## [4.0.0-rc.0] -- 2026-07-21

### Added
Expand Down
4 changes: 2 additions & 2 deletions CITATION.cff
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ authors:
- family-names: "Samimi"
given-names: "Mojtaba"
title: "Open source Plotly charting library"
version: 3.7.0
version: 4.0.0
doi: 10.5281/zenodo.13964707
date-released: 2026-07-03
date-released: 2026-08-24
url: "https://github.com/plotly/plotly.js"
6 changes: 3 additions & 3 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.7.0.min.js" charset="utf-8"></script>
<script src="https://cdn.plot.ly/plotly-4.0.0.min.js" charset="utf-8"></script>
</head>
<body>
<div id="gd"></div>
Expand All @@ -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.7.0.min.js"
import "https://cdn.plot.ly/plotly-4.0.0.min.js"
Plotly.newPlot("gd", [{ y: [1, 2, 3] }])
</script>
```
Expand All @@ -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.7.0.js" charset="utf-8"></script>
<script src="https://cdn.plot.ly/plotly-4.0.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.
Expand Down
54 changes: 27 additions & 27 deletions dist/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -43,12 +43,12 @@ The main plotly.js bundles weight in at:

| plotly.js | plotly.min.js | plotly.min.js + gzip | plotly-with-meta.js |
|-----------|---------------|----------------------|---------------------|
| 8.9 MB | 3.9 MB | 1.2 MB | 9.3 MB |
| 9.65 MB | 4.29 MB | 1.33 MB | 10 MB |

#### CDN links
> https://cdn.plot.ly/plotly-4.0.0-rc.0.js
> https://cdn.plot.ly/plotly-4.0.0.js

> https://cdn.plot.ly/plotly-4.0.0-rc.0.min.js
> https://cdn.plot.ly/plotly-4.0.0.min.js


#### npm packages
Expand Down Expand Up @@ -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 | 369.7 kB |
| 2.93 MB | 1.18 MB | 397 kB |

#### CDN links
> https://cdn.plot.ly/plotly-basic-4.0.0-rc.0.js
> https://cdn.plot.ly/plotly-basic-4.0.0.js

> https://cdn.plot.ly/plotly-basic-4.0.0-rc.0.min.js
> https://cdn.plot.ly/plotly-basic-4.0.0.min.js


#### npm packages
Expand All @@ -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 | 468.6 kB |
| 3.69 MB | 1.48 MB | 498 kB |

#### CDN links
> https://cdn.plot.ly/plotly-cartesian-4.0.0-rc.0.js
> https://cdn.plot.ly/plotly-cartesian-4.0.0.js

> https://cdn.plot.ly/plotly-cartesian-4.0.0-rc.0.min.js
> https://cdn.plot.ly/plotly-cartesian-4.0.0.min.js


#### npm packages
Expand All @@ -137,12 +137,12 @@ The `geo` partial bundle contains trace modules `choropleth`, `scatter` and `sca

| Raw size | Minified size | Minified + gzip size |
|------|-----------------|------------------------|
| 3.1 MB | 1.3 MB | 435.1 kB |
| 3.37 MB | 1.38 MB | 466 kB |

#### CDN links
> https://cdn.plot.ly/plotly-geo-4.0.0-rc.0.js
> https://cdn.plot.ly/plotly-geo-4.0.0.js

> https://cdn.plot.ly/plotly-geo-4.0.0-rc.0.min.js
> https://cdn.plot.ly/plotly-geo-4.0.0.min.js


#### npm packages
Expand All @@ -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.5 kB |
| 4.51 MB | 1.74 MB | 560 kB |

#### CDN links
> https://cdn.plot.ly/plotly-gl3d-4.0.0-rc.0.js
> https://cdn.plot.ly/plotly-gl3d-4.0.0.js

> https://cdn.plot.ly/plotly-gl3d-4.0.0-rc.0.min.js
> https://cdn.plot.ly/plotly-gl3d-4.0.0.min.js


#### npm packages
Expand All @@ -183,12 +183,12 @@ The `gl2d` partial bundle contains trace modules `parcoords`, `scatter`, `scatte

| Raw size | Minified size | Minified + gzip size |
|------|-----------------|------------------------|
| 3.9 MB | 1.5 MB | 526.5 kB |
| 3.67 MB | 1.47 MB | 497 kB |

#### CDN links
> https://cdn.plot.ly/plotly-gl2d-4.0.0-rc.0.js
> https://cdn.plot.ly/plotly-gl2d-4.0.0.js

> https://cdn.plot.ly/plotly-gl2d-4.0.0-rc.0.min.js
> https://cdn.plot.ly/plotly-gl2d-4.0.0.min.js


#### npm packages
Expand All @@ -206,12 +206,12 @@ The `map` partial bundle contains trace modules `choroplethmap`, `densitymap`, `

| Raw size | Minified size | Minified + gzip size |
|------|-----------------|------------------------|
| 4.2 MB | 2 MB | 632.3 kB |
| 4.9 MB | 2.42 MB | 733 kB |

#### CDN links
> https://cdn.plot.ly/plotly-map-4.0.0-rc.0.js
> https://cdn.plot.ly/plotly-map-4.0.0.js

> https://cdn.plot.ly/plotly-map-4.0.0-rc.0.min.js
> https://cdn.plot.ly/plotly-map-4.0.0.min.js


#### npm packages
Expand All @@ -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 | 403.5 kB |
| 3.18 MB | 1.28 MB | 431 kB |

#### CDN links
> https://cdn.plot.ly/plotly-finance-4.0.0-rc.0.js
> https://cdn.plot.ly/plotly-finance-4.0.0.js

> https://cdn.plot.ly/plotly-finance-4.0.0-rc.0.min.js
> https://cdn.plot.ly/plotly-finance-4.0.0.min.js


#### npm packages
Expand All @@ -252,12 +252,12 @@ The `strict` partial bundle contains trace modules `bar`, `barpolar`, `box`, `ca

| Raw size | Minified size | Minified + gzip size |
|------|-----------------|------------------------|
| 9.7 MB | 4.2 MB | 1.3 MB |
| 10.5 MB | 4.64 MB | 1.43 MB |

#### CDN links
> https://cdn.plot.ly/plotly-strict-4.0.0-rc.0.js
> https://cdn.plot.ly/plotly-strict-4.0.0.js

> https://cdn.plot.ly/plotly-strict-4.0.0-rc.0.min.js
> https://cdn.plot.ly/plotly-strict-4.0.0.min.js


#### npm packages
Expand Down
Loading
Loading