v3.14 Release Notes
firstname.lastname@example.org release (September 2021 #1)
This is the final minor release for gatsby v3. Gatsby v4 beta is already published behind the
nextnpm tag and the next stable release will be
email@example.com. See what’s inside!
We will keep publishing patches for 3.14.x with hotfixes until
4.0.0stable is published and at least several weeks after.
Key highlights of this release:
- Better UX for navigation in the middle of deployment
- New developer tools -
createPagessnippet in GraphiQL and new GraphQL capability
- Preparations for gatsby v4 - API deprecations; migration guide; docs
- Improvements for
- New home for
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.
This release solves a common UX problem with navigation in the middle of deployment. Imagine the following scenario:
- Users loads a page
- New version of the site is deployed
- User tries to navigate to another page with
However, nothing happens and there are some JS errors in the console.
It happens because paths of JS chunks change with the new deployment and so the old chunks cannot be found. This problem is now addressed in Gatsby automatically. Once we spot this error, the page is hard-reloaded for the user.
Often, a developer will begin creating the site by examining their data layer in GraphiQL. They will then want to create pages based off of their initial query. For example:
Usually this will end up with this code in
Doing it manually is tedious, but now you can generate this snippet from GraphiQL
and paste to
See PR #32968 for details.
Now you can apply
group to grouped nodes. In other words,
a query like this is now possible:
See PR #32533 for details.
Actions used for schema customization should not be used in
sourceNodes API anymore:
Usage of those actions in
sourceNodes is deprecated as of this release and will break in Gatsby v4.
The plugin got a fair share of improvements and bugfixes for warm and incremental builds:
- Fix GraphQL schema errors and crashes when deleting nodes, PRs #32971, #33099, #33143 and #33181
- Warn on bad webhook format: PR #33079
- Add tracing for full/delta fetches and http requests: PR #33142
The plugin is moved to https://github.com/netlify/gatsby-plugin-netlify Go check it out for the latest source code.
gatsby: make conditional page builds work with static queries, via PR #32949
gatsby: reduce page-renderer size, via PR #33051
gatsby: fix nesting of tracing spans + add docs for OpenTelemetry, via PR #33098
gatsby: don’t bundle moment locale files, via PR #33092
gatsby: add environment variable for setting tracing config file, via PR #32513
gatsby: Assign parentSpan to activities that were missing them, via PR #33122
gatsby-source-contentful: fix error “Unable to download asset”, via PR #33024
gatsby-transformer-sqip: ensure failed asset downloads do not break build, via PR #33037
gatsby-plugin-google-tagmanager: ability to serve gtm.js from “self-hosted” tagging server, via PR #32733
gatsby-plugin-styled-components: Add ability to disable vendor prefixes, via PR #33147
A big Thank You to our community who contributed to this release 💜