Migrate to Netlify Today

Netlify announces the next evolution of Gatsby Cloud. Learn more

v3.5 Release Notes

Welcome to gatsby@3.5.0 release (May 2021 #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.

Previous release notes

Full changelog

Performance Improvements

We’re always working hard on making Gatsby faster. In this release we shipped three improvements:

  • Speedup CLI startup by lazily requiring some modules. PR #31134
  • Create page object & SitePage node in same action creator. In our synthetic create-pages benchmark (for 100K pages) this reduced the createPages activity from 16s to 4.5s (~70% drop) and peak RSS memory from 1.4gb to 0.7gb (~50% drop). PR #31104
  • Up to ~20% improvement to running queries by switching to a faster queue library (fastq). The improvements are most noticeable if you use the fastest query filters (e.g. eq filter on the id property) and don’t do CPU intensive work in query running e.g. process markdown or MDX. PR #31269

gatsby-graphql-source-toolkit v2

The gatsby-graphql-source-toolkit simplifies data sourcing from remote GraphQL APIs into Gatsby. While it’s not a source plugin by itself, it helps you writing custom GraphQL source plugins by providing a set of convenience tools and conventions. Craft CMS or GraphCMS use it for their source plugins.

The bump to a new major version ensures compatibility with gatsby@^3.0.0. No breaking changes were in this release.

New SSR in Develop overlay

Previously the error overlay (when the page didn’t successfully SSR) consisted out of a HTML page served by express. But that wasn’t tied into our already existing Fast Refresh overlay we use throughout Gatsby. The information on the page stays the same but it now has the look & feel of all our other errors:

A modal showing that the page failed to SSR and showing a code block with the exact location of the error. Optionally you can reload the page or skip SSR rendering for now.

Documentation Updates

Notable bugfixes & improvements

  • Fix support of theme shadowing in monorepo PR #30435
  • Fix scroll restoration for layout components PR #26861
  • gatsby-plugin-mdx: make HMR work again for MDX PR #31288
  • gatsby-plugin-preact: enable error-overlay PR #30613
  • gatsby-plugin-sitemap: allow writing sitemap to the root of the public folder PR #31130
  • gatsby-transformer-remark: restore support for footnotes PR #31019
  • Add ImageDataLike as an exported type of gatsby-plugin-image PR #30590
  • Update the public plugin API types PR #30819


A big Thank You to our community who contributed to this release 💜

Start building today on Netlify!
Edit this page on GitHub
© 2023 Gatsby, Inc.