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

What's Changed

feat: support React 19 by @serhalp in #39306
feat: support Node.js 24 by @serhalp in #39380 and #39398
fix(deps): bump body-parser to resolve qs vulnerability warning by @serhalp in #39396
chore(docs,starters): remove misc. outdated, invalid, or misleading instructions by @serhalp in #39363

React 19

[!NOTE]
🔐 As of January 26 2026, none of the React 19 security vulnerabilities affect Gatsby.

🚀 React 19 is here!

React 19 is now officially supported by Gatsby and all gatsby- packages maintained by the Gatsby team.

This is not a breaking change. You can safely upgrade to this release while staying on React 18.

All packages' peer dependencies on react and react-dom have been extended from ^18.0.0 to ^18.0.0 || ^19.0.0.

All existing stable Gatsby functionality is intended to now work with React 19.

PR: #39306

Upgrade Guide

[!WARNING]
Community plugins may not have been updated yet to support React 19, so please check their repository for the current status. All plugins managed by the Gatsby team (in the gatsbyjs/gatsby repository) have been updated.

To upgrade to React 19, first upgrade gatsby and all your dependencies that start with gatsby- to the latest version. (Check out this guide if you need help with that.)

[!TIP]
If you use npm 7 or higher you’ll want to use the --legacy-peer-deps option. For example, if you use gatsby and gatsby-plugin-postcss:
npm install --legacy-peer-deps gatsby@latest gatsby-plugin-postcss@latest

Then, follow the React 19 upgrade guide. No other changes are required.

Please note:

Some new React 19 features may not be available yet via Gatsby.
- Notably, the new document metadata hoisting feature is disabled in Gatsby, as it conflicts with the existing Gatsby Head API
Gatsby Partial Hydration, an experimental feature for three years now, is known to be incompatible with React 19 at this time. If you rely on this feature, do not upgrade to React 19.

New features

Gatsby now supports React 19's new root error callbacks.

Users can export onCaughtError and onUncaughtError from their gatsby-browser.js to handle errors caught by error boundaries and uncaught errors respectively:

// gatsby-browser.js

export const onCaughtError = ({ error, errorInfo }) => {
  // e.g. send to an error tracking service
  myErrorTracker.reportError(error, { extra: errorInfo })
}

export const onUncaughtError = ({ error, errorInfo }) => {
  // e.g. send to an error tracking service
  myErrorTracker.captureException(error, { extra: errorInfo })
}

In development, these errors also appear in Gatsby's Fast Refresh error overlay. These callbacks are only invoked in React 19.

Node.js 24

Node.js 24 is now officially supported by Gatsby.

PR: #39380 and #39398

Notable bugfixes & improvements

gatsby, gatsby-source-drupal:
- fix(deps): bump body-parser to resolve qs vulnerability warning by @serhalp in #39396
chore: remove misc. outdated, invalid, or misleading contributor instructions by @serhalp in #39363

Full Changelog: https://github.com/gatsbyjs/gatsby/compare/[email protected]@5.16.0

`v5.15.0`

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`

gatsbyjs/gatsby (gatsby-plugin-catch-links)

`v5.16.0`

Bug Fixes

use more explicit node.js version range #39398 (c355640)

Other Changes

Revert "chore(release): Publish next pre-minor" (3539ec8)

`v5.15.0`

Note: Version bump only for package gatsby-plugin-catch-links

`v5.14.0`

Note: Version bump only for package gatsby-plugin-catch-links

5.13.1 (2024-01-23)

Note: Version bump only for package gatsby-plugin-catch-links

`v5.13.1`

Note: Version bump only for package gatsby-plugin-catch-links

5.13.1 (2024-01-23)

Note: Version bump only for package gatsby-plugin-catch-links

`v5.13.0`

Note: Version bump only for package gatsby-plugin-catch-links

`v5.12.0`

Note: Version bump only for package gatsby-plugin-catch-links

`v5.11.0`

Note: Version bump only for package gatsby-plugin-catch-links

`v5.10.0`

Note: Version bump only for package gatsby-plugin-catch-links

`v5.9.0`

Note: Version bump only for package gatsby-plugin-catch-links

`v5.8.0`

Note: Version bump only for package gatsby-plugin-catch-links

`v5.7.0`

Note: Version bump only for package gatsby-plugin-catch-links

`v5.6.0`

Bug Fixes

update babel monorepo #37568 (13a0a9e)

`v5.5.0`

Note: Version bump only for package gatsby-plugin-catch-links

`v5.4.0`

Chores

update babel monorepo #37386 (b941876)

`v5.3.0`

Note: Version bump only for package gatsby-plugin-catch-links

`v5.2.0`

Note: Version bump only for package gatsby-plugin-catch-links

`v5.1.0`

Note: Version bump only for package gatsby-plugin-catch-links

`v5.0.0`

Chores

Update peerDeps #36965 (b624442)
apply patches for v5 #36796 (25f79b6)

gatsbyjs/gatsby (gatsby-plugin-google-gtag)

`v5.16.0`