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/[email protected]@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 [email protected]: The engine "node" is incompatible with this module. Expected version "20 || >=22". Got "18.6.0"

Full Changelog: https://github.com/gatsbyjs/gatsby/compare/[email protected]@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/[email protected]@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/[email protected]@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/[email protected]@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/[email protected]@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 [email protected] 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 [email protected] 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 [email protected] 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 [email protected] 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 [email protected] 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 [email protected] 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 [email protected] 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 [email protected] 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 [email protected] 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 [email protected] 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 [email protected] 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 [email protected] 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 [email protected] 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.

`v4.25.9`

`v4.25.8`

`v4.25.7`

`v4.25.6`

`v4.25.5`

`v4.25.4`

`v4.25.3`

`v4.25.2`

`v4.25.1`

`v4.25.0`

`v4.24.8`

`v4.24.7`

`v4.24.6`

`v4.24.5`

`v4.24.4`

`v4.24.3`

`v4.24.2`

`v4.24.1`

`v4.24.0`: v4.24

Welcome to [email protected] release (September 2022 #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.

`v4.23.1`

`v4.23.0`: v4.23

Welcome to [email protected] release (September 2022 #1)

Key highlights of this release:

Open RFCs

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

`v4.22.1`

`v4.22.0`: v4.22

Welcome to [email protected] release (August 2022 #3)

Key highlights of this release:

Open RFCs

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

`v4.21.1`

`v4.21.0`: v4.21

Welcome to [email protected] release (August 2022 #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.

`v4.20.0`: v4.20

Welcome to [email protected] release (August 2022 #1)

Key highlights of this release:

RFC for changes in sort and aggregation fields in Gatsby GraphQL Schema
Release Candidate for gatsby-plugin-mdx v4 - Support for MDX v2 and more!

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

`v4.19.2`

`v4.19.1`

`v4.19.0`: v4.19

Welcome to [email protected] release (July 2022 #2)

Key highlights of this release:

Gatsby Head API - Better performance & more future-proof than react-helmet
Release Candidate for gatsby-plugin-mdx v4 - Support for MDX v2 and more!

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

`v4.18.2`

`v4.18.1`

`v4.18.0`: v4.18

Welcome to [email protected] release (July 2022 #1)

Key highlights of this release:

typesOutputPath option for GraphQL Typegen - Configure the location of the generated TypeScript types
Server Side Rendering (SSR) in development - Find bugs & hydration errors more easily during gatsby develop
Open RFCs - MDX v2 & Metadata management

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

`v4.17.2`

`v4.17.1`

`v4.17.0`: v4.17

Welcome to [email protected] release (June 2022 #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.

`v4.16.0`: v4.16

Welcome to [email protected] release (June 2022 #1)

Key highlights of this release:

Also check out notable bugfixes.

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

`v4.15.2`

`v4.15.1`

`v4.15.0`: v4.15

Welcome to [email protected] release (May 2022 #2)

Key highlights of this release:

Also check out notable bugfixes.

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

[Full changelog][full-changelog]

`v4.14.1`

`v4.14.0`: v4.14

Welcome to [email protected] release (May 2022 #1)

Key highlights of this release:

Also check out notable bugfixes.

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

`v4.13.1`

`v4.13.0`: v4.13

Welcome to [email protected] release (April 2022 #2)

Key highlights of this release:

Also check out notable bugfixes.

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

`v4.12.1`

`v4.12.0`: v4.12

Welcome to [email protected] release (April 2022 #1)

Key highlights of this release:

New RFCs

Also check out notable bugfixes.

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

`v4.11.3`

`v4.11.2`

`v4.11.1`

`v4.11.0`: v4.11

Welcome to [email protected] release (March 2022 #3)

Key highlights of this release:

Also check out notable bugfixes.

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

`v4.10.3`

`v4.10.2`

`v4.10.1`

`v4.10.0`: v4.10

Welcome to [email protected] release (March 2022 #2)

Key highlights of this release:

Image CDN

Also check out notable bugfixes.

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

`v4.9.3`