Search code, repositories, users, issues, pull requests...

What's Changed

fix: support node 22 by @serhalp in #39349
fix(gatsby): update socket.io to address vulnerable subdeps by @serhalp in #39352

Node.js 22

This release formally introduces Node.js 22 support, which is officially tested and supported going forward.

If you wish to use Node.js 22 with Gatsby, we highly recommend using the latest 22.x release, as there are known issues with some older 22.x versions that Gatsby is unable to work around at this time.

⚠️ Known Issue: `gatsby develop` fails with Node.js 22.7.0, 22.8.0, and 22.9.0

There is a critical bug in Node.js (nodejs/node#55145?) affecting versions 22.7.0, 22.8.0, and 22.9.0 that causes gatsby develop to fail with the error reported in #39068.

👉🏼 To avoid this, use Node.js 22.10.0 or later. (You can also use 22.6.0 or earlier.)

⚠️ Known Issue: Page loads may hang in dev with experimental `DEV_SSR` enabled and Node.js ≥22.14.0 (or ≥20.19.0)

This will not affect most users.

A change landed in Node.js 20.19.0 and 22.14.0 results in requests to the gatsby develop dev server to occasionally hang for 15 seconds. This can only occur if you have opted in to the experimental DEV_SSR flag.

👉🏼 To avoid this, disable the experimental DEV_SSR flag. (You can also downgrade to Node.js 22.13.1 or earlier, 20.18.3 or earlier, or 18.x.)

New Contributors

Thank you!

@pajosieg made their first contribution in #39169
@johnmurphy01 made their first contribution in #39324
@shrisoundharyaa made their first contribution in #39286

Full Changelog: https://github.com/gatsbyjs/gatsby/compare/gatsby@5.14.6...gatsby@5.15.0

`v5.14.6`

2025-08-06

What's Changed

fix: don't treat timestamps as dynamic paths (#39340) by @gatsbybot in #39341
fix: use forked devcert to avoid pulling transitive deps from its @types/* deps (#39343) by @gatsbybot in #39345
- This fixes npm install errors/warnings with Node.js 18 that look like error glob@11.0.3: The engine "node" is incompatible with this module. Expected version "20 || >=22". Got "18.6.0"

Full Changelog: https://github.com/gatsbyjs/gatsby/compare/gatsby@5.14.5...gatsby@5.14.6

`v5.14.5`

2025-06-19

What's Changed

fix: ensure rendering engine has vendored libvips (#39317) by @gatsbybot in #39320

Full Changelog: https://github.com/gatsbyjs/gatsby/compare/gatsby@5.14.4...gatsby@5.14.5

`v5.14.4`

2025-06-06

What's Changed

fix(deps): upgrade multer to resolve 3 security vulnerabilities (#39307) by @gatsbybot in #39308

Full Changelog: https://github.com/gatsbyjs/gatsby/compare/gatsby@5.14.3...gatsby@5.14.4

`v5.14.3`

2025-04-09

What's Changed

fix: Align types of rootNodeMap during root node tracking (#39262) by @gatsbybot in #39270

Full Changelog: https://github.com/gatsbyjs/gatsby/compare/gatsby@5.14.2...gatsby@5.14.3

`v5.14.2`

2025-04-07

What's Changed

fix: pin isNonNullType is not defined with webpack>=5.99.0 (#39264) by @gatsbybot in #39265

Full Changelog: https://github.com/gatsbyjs/gatsby/compare/gatsby@5.14.1...gatsby@5.14.2

`v5.14.1`

`v5.14.0`: v5.14.0

This release focused on performance improvements and security fixes.

What's Changed

minor docs improvements: #38816, #39052, #39133, #39060
security fixes:
- bump gh-pages: #39089
- bump underscore: #39092
- bump thenify: #39095
- bump axios: #39101 #39118
- bump ejs: #39093
- bump set-getter: #39091
- bump express: #39099
- bump express: #39098
- bump css-what: #39107
- bump rollup: #39112 #39115
- bump body-parser: #39097 #39132
- bump webpack-dev-middleware: #39106
- bump path-to-regexp: #39096
[gatsby, create-gatsby, gatsby-cli, gatsby-dev-cli, gatsby-plugin-gatsby-cloud, gatsby-plugin-page-creator] perf: disable telemetry reporting #39137

See full release notes

`v5.13.7`: v5.13.7

2024-07-12

What's Changed

fix(gatsby-adapter-netlify): support monorepos (#39005) by @gatsbybot in #39037

See full release notes: #39046

`v5.13.6`: v5.13.6

2024-05-29

What's Changed

perf(gatsby-adapter-netlify): improve adapt() performance (#38988) by @gatsbybot in #38991

See full release notes: #39004

`v5.13.5`: v5.13.5

2024-05-17

What's Changed

chore: pin @vercel/webpack-asset-relocator-loader (#38981) by @gatsbybot in #38982
feat: allow dsg/ssr renders without access to datastore if it's not required (#38974) by @gatsbybot in #38979

See full release notes: #38984

`v5.13.4`: v5.13.4

2024-04-10

What's Changed

fix(gatsby-source-wordpress): only diff wpgraphql schema if the user opts in (#38856) by @gatsbybot in #38860
chore(gatsby-source-wordpress): upgrade file-type (#38861) by @gatsbybot in #38863
fix(gatsby-adapter-netlify): handler generation on windows (#38900) by @gatsbybot in #38929

See full release notes: #38969

`v5.13.3`: v5.13.3

2024-01-24

What's Changed

perf: use must-revalidate cache-control header as common and only create header routes for routes with different cache-control (#38820) by @gatsbybot in #38824
fix: add missing fs method rewrites to handle fetchRemoteFile in dsg/ssr engine (#38822) by @gatsbybot in #38823

See full release notes: #38834

`v5.13.2`: v5.13.2

2024-01-23

What's Changed

fix(gatsby): more robust adapter zero-conf handling (#38778) by @gatsbybot in #38800
fix(gatsby): try to automatically recover when parcel segfaults (#38773) by @gatsbybot in #38799
fix(gatsby): fix webpack compilation when pnpm is used (#38757) by @gatsbybot in #38804
chore: swap babel-plugin-lodash with updated version that doesn't use deprecated APIs (#38797) by @gatsbybot in #38803
fix(gatsby): support builtin modules prefixed with node: on build-html (#38516) by @gatsbybot in #38818

See full release notes: #38821

`v5.13.1`: v5.13.1

2013-12-22

What's Changed

fix(docs): update remote url docs (#38768) by @gatsbybot in #38770
chore(gatsby-cli,gatsby-source-wordpress): bump clipboardy (#38775) by @gatsbybot in #38776

See full release notes: #38796.

`v5.13.0`: v5.13.0

Welcome to gatsby@5.13.0 release (December 2023 #1)

Key highlight of this release:

Custom Image and File CDN URL generators

Bleeding Edge: Want to try new features as soon as possible? Install gatsby@next and let us know if you have any issues.

Welcome to gatsby@5.12.0 release (August 2023 #1)

Key highlight of this release:

Adapters

Bleeding Edge: Want to try new features as soon as possible? Install gatsby@next and let us know if you have any issues.

`v5.11.0`: v5.11.0

Welcome to gatsby@5.11.0 release (June 2023 #1)

Key highlights of this release:

Bleeding Edge: Want to try new features as soon as possible? Install gatsby@next and let us know if you have any issues.

`v5.10.0`: v5.10.0

Welcome to gatsby@5.10.0 release (May 2023 #1)

This release focused on bug fixes and perf improvements. Check out notable bugfixes and improvements.

Bleeding Edge: Want to try new features as soon as possible? Install gatsby@next and let us know if you have any issues.

`v5.9.1`

`v5.9.0`: v5.9.0

Welcome to gatsby@5.9.0 release (April 2023 #1)

Key highlights of this release:

Bleeding Edge: Want to try new features as soon as possible? Install gatsby@next and let us know if you have any issues.

`v5.8.1`

`v5.8.0`

`v5.7.0`: v5.7.0

Welcome to gatsby@5.7.0 release (February 2023 #2)

This release focused on bug fixes and perf improvements. Check out notable bugfixes and improvements.

Bleeding Edge: Want to try new features as soon as possible? Install gatsby@next and let us know if you have any issues.

`v5.6.1`

`v5.6.0`: v5.6.0

Welcome to gatsby@5.6.0 release (February 2023 #1)

Key highlights of this release:

Bleeding Edge: Want to try new features as soon as possible? Install gatsby@next and let us know if you have any issues.

`v5.5.0`: v5.5.0

Welcome to gatsby@5.5.0 release (January 2023 #2)

Key highlights of this release:

Bleeding Edge: Want to try new features as soon as possible? Install gatsby@next and let us know if you have any issues.

`v5.4.2`

`v5.4.1`

`v5.4.0`: v5.4.0

Welcome to gatsby@5.4.0 release (January 2023 #1)

The whole team took time off for a much deserved winter break and we hope you had relaxing holidays, too! Before the break we spent time doing maintenance work such as updating internal dependencies or fixing some smaller bugs here and there. In case you missed it, we shipped ES Modules (ESM) in Gatsby files in the last release.

So check out the notable bugfixes section to learn more.

Bleeding Edge: Want to try new features as soon as possible? Install gatsby@next and let us know if you have any issues.

`v5.3.3`

`v5.3.2`

`v5.3.1`

`v5.3.0`: v5.3.0

Welcome to gatsby@5.3.0 release (December 2022 #1)

Key highlights of this release:

Bleeding Edge: Want to try new features as soon as possible? Install gatsby@next and let us know if you have any issues.

`v5.2.0`: v5.2.0

Welcome to gatsby@5.2.0 release (November 2022 #3)

This is an out of band release due to the removal of the Potrace library in Gatsby. We'll continue with our biweekly schedule as normal.

Bleeding Edge: Want to try new features as soon as possible? Install gatsby@next and let us know if you have any issues.

`v5.1.0`: v5.1.0

Welcome to gatsby@5.1.0 release (November 2022 #2)

This is the first minor release after the recent major release of Gatsby 5! We are focused on your feedback and implementing fixes as needed.

If you haven’t migrated yet, please refer to the migration guide. We’ve done our best to make the transition smooth!

Some brief notes about what Gatsby 5 brings to the table:

Slices API unlocks up to 90% reduction in build duration for content changes in highly shared components
Partial Hydration allows you to ship only the necessary JavaScript to the browser

Bleeding Edge: Want to try new features as soon as possible? Install gatsby@next and let us know if you have any issues.

`v5.0.1`

`v5.0.0`: v5.0.0

Welcome to gatsby@5.0.0 release (November 2022 #1)

Key highlights of this release:

Slice API - Only re-build individual slices of your page
Partial Hydration (Beta) - Improve frontend performance by shipping less JavaScript
GraphiQL v2 - An all new UI with features like dark mode, tabs, and persisted state
Performance Improvements

Major dependency updates:

Bleeding Edge: Want to try new features as soon as possible? Install gatsby@next and let us know if you have any issues.

gatsbyjs/gatsby (gatsby-plugin-image)

`v3.15.0`

Bug Fixes

update dependency chokidar to ^3.6.0 #39174 (5717252)

`v3.14.0`

Bug Fixes

update dependency fs-extra to ^11.2.0 #38727 (cb33fe5)

3.13.1 (2024-01-23)

Note: Version bump only for package gatsby-plugin-image

`v3.13.1`

Bug Fixes

update dependency fs-extra to ^11.2.0 #38727 (cb33fe5)

3.13.1 (2024-01-23)

Note: Version bump only for package gatsby-plugin-image

`v3.13.0`

Note: Version bump only for package gatsby-plugin-image

3.12.3 (2023-10-26)

Note: Version bump only for package gatsby-plugin-image

3.12.2 (2023-10-20)

Note: Version bump only for package gatsby-plugin-image

3.12.1 (2023-10-09)

Note: Version bump only for package gatsby-plugin-image

`v3.12.3`

Note: Version bump only for package gatsby-plugin-image

3.12.3 (2023-10-26)

Note: Version bump only for package gatsby-plugin-image

3.12.2 (2023-10-20)

Note: Version bump only for package gatsby-plugin-image

3.12.1 (2023-10-09)

Note: Version bump only for package gatsby-plugin-image

`v3.12.2`

Note: Version bump only for package gatsby-plugin-image

3.12.3 (2023-10-26)

Note: Version bump only for package gatsby-plugin-image

3.12.2 (2023-10-20)

Note: Version bump only for package gatsby-plugin-image

3.12.1 (2023-10-09)

Note: Version bump only for package gatsby-plugin-image

`v3.12.1`

Note: Version bump only for package gatsby-plugin-image

3.12.3 (2023-10-26)

Note: Version bump only for package gatsby-plugin-image

3.12.2 (2023-10-20)

Note: Version bump only for package gatsby-plugin-image

3.12.1 (2023-10-09)

Note: Version bump only for package gatsby-plugin-image

`v3.12.0`

Features

Adapters #38232 (b2d4aef)

Bug Fixes

update dependency semver to ^7.5.3 #38296 (11e64e2)
update typescript #38324 (5d0d7c1)

`v3.11.0`

Bug Fixes

update typescript #38133 (aa7a078)

Chores

update semver #38171 (208cdef)

`v3.10.0`

Bug Fixes

update dependency semver to ^7.5.0 #38023 (2564f6b)

`v3.9.0`

Bug Fixes

update dependency fs-extra to ^11.1.1 #37827 (3e9a590)
update typescript to v5 (major) #37906 (3859ba6)

Chores

update typescript #37848 (9f92796)
update [dev] minor and patch dependencies for gatsby-plugin-image #37816 (67a4a88)

`v3.8.0`

Note: Version bump only for package gatsby-plugin-image

`v3.7.0`

Note: Version bump only for package gatsby-plugin-image

`v3.6.0`

Bug Fixes

update babel monorepo #37568 (13a0a9e)

Chores

update [dev] minor and patch dependencies for gatsby-plugin-image #37584 (c997776)
update typescript #37596 (4f1d1f2)

`v3.5.0`

Chores

Upgrade some non-breaking major versions #37406 (2ea80c0)

`v3.4.0`

Bug Fixes

Encode space in data SVG URI #37241 (09ea753)
Normalize filename for correct hashing #37262 (397fa3f)

Chores

update babel monorepo #37386 (b941876)
update [dev] minor and patch dependencies for gatsby-plugin-image #37352 (4c2ac49)

3.3.2 (2022-12-14)

Bug Fixes

Normalize filename for correct hashing #37262 #37263 (b7477f4)

3.3.1 (2022-12-14)

Note: Version bump only for package gatsby-plugin-image

`v3.3.2`

Bug Fixes

Encode space in data SVG URI #37241 (09ea753)
Normalize filename for correct hashing #37262 (397fa3f)

Chores

update babel monorepo #37386 (b941876)
update [dev] minor and patch dependencies for gatsby-plugin-image #37352 (4c2ac49)

3.3.2 (2022-12-14)

Bug Fixes

Normalize filename for correct hashing #37262 #37263 (b7477f4)

3.3.1 (2022-12-14)

Note: Version bump only for package gatsby-plugin-image

`v3.3.1`

Bug Fixes

Encode space in data SVG URI #37241 (09ea753)
Normalize filename for correct hashing #37262 (397fa3f)

Chores

update babel monorepo #37386 (b941876)
update [dev] minor and patch dependencies for gatsby-plugin-image #37352 (4c2ac49)

3.3.2 (2022-12-14)

Bug Fixes

Normalize filename for correct hashing #37262 #37263 (b7477f4)

3.3.1 (2022-12-14)

Note: Version bump only for package gatsby-plugin-image

`v3.3.0`

Bug Fixes

Ensure cache hash is unique #37087 (c98d947)

Chores

update dependency typescript to ^4.9.3 #37192 (204ed0e)
update semver #37186 (34adbf1)

`v3.2.0`

Chores

remove tracedSVG #37093 (94c2d73)
Add peerDependenciesMeta #35146 (c935f05)

`v3.1.0`

Note: Version bump only for package gatsby-plugin-image

`v3.0.0`