v3.3 Release Notes
firstname.lastname@example.org release (April 2021 #1)
Key highlights of this release:
- Performance optimizations - faster JS bundling, lower peak memory usage
- Upgrade to the latest
sharp- built-in image optimizations; and now works on M1 Macs
- Upgrade to the latest
remark- more consistency in Markdown rendering
- Bugfixes in
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 adds memoization of babel loader options. It significantly reduces the overhead in JS compilation step. With our sample site we saw a speed-up in JS bundling up to 30-40%
Note: this improvement only affects JS bundling, so if you use other heavy transformations (CSS-in-JS, Mdx, etc), you will likely see modest improvements.
This release restricts concurrency of html-file generation which can greatly reduce memory and disk pressure and decrease spikes in memory usage — especially for sites with many 100s+ pages and large page-data.json files. With our example site we saw a decrease in peak memory usage from ~3.5 GB to ~1.7 GB (without negative effects to build time).
Remark has had a significant major upgrade
recently (version 13) and changed the underlying parser. The ecosystem has almost caught up
since then, so we’ve decided to release new major versions of all our
The following plugins are now fully compatible with
We’ve tried to make the migration effortless and non-breaking (just update the dependencies) but there are subtle differences in HTML output caused by the new remark parser. We’ve identified and listed the most common differences in this discussion (if you spot other notable changes - please comment there!)
Also check out remark changelog, specifically the section: “Changes to output / the tree”.
The only plugin provided by Gatsby that is not compatible yet with
This plugin relies on the upstream remark plugin
remark-custom-blocks which is itself not compatible with
The work on updating it is in progress though, and as soon as it is finished we will publish the new major version for our plugin as well.
In the meantime if you use this plugin you can just wait when it’s ready or modify your markdown
and switch to another syntax. Remark authors suggest
remark-directive as an alternative.
to-gatsby-remark-plugin package to convert it to Gatsby remark plugin.
Check out Sharp changelog for a full list of changes.
The most important highlights of the new release:
- Smaller install size
- Supports Mac M1: now uses prebuilt libvips binaries for M1 Macs
- Includes buil-in image optimization (unlocks future perf improvements in Gatsby)
- Fix a bug that caused errors in third party packages that access the
- Fix a bug that prevented
draggable="false"being set on the
- Fix a bug that caused blurred previews to be generated at the wrong aspect ratio
- Fix a bug that prevented lazy-loaded images displaying in Safari
- Fix a bug that caused duplicate type errors when using Contentful images with other plugins that implement images
- Fixed invalid query results in cached builds PR #30594
- Schema customization: merge fields of interfaces defined by multiple plugins PR #30501
- Fix for IE11: add dom collections to polyfills PR #30483
A big Thank You to our community who contributed to this release 💜
- fix(gatsby-source-contentful): Improve network error handling PR #30257
- chore(contentful): create compiled files in dist instead of . PR #30414
- fix(examples): Update using-contentful to use gatsby-plugin-image PR #29526
- build(using-contentful): add missing sharp dependency PR #30546
- feat(gatsby-source-contentful): Increase Contentful sync by up to 10x PR #30422
- fix(contentful): set proper defaults for gatsby-plugin-image PR #30536
- feat(gatsby-source-contentful): update docs and improve errors PR #30538
- fix(gatsby-source-contentful): Contentful page limit backoff PR #30549
- fix(contentful): ensure fragments are properly distributed PR #30555
- fix(using-contentful): clean up dependencies PR #30556
- fix(contentful): make gatsby-plugin-image a peer dependency PR #30709