Gathering detailed insights and metrics for @netlify/plugin-gatsby
Gathering detailed insights and metrics for @netlify/plugin-gatsby
Gathering detailed insights and metrics for @netlify/plugin-gatsby
Gathering detailed insights and metrics for @netlify/plugin-gatsby
gatsby-plugin-netlify
A Gatsby plugin for sites deployed to Netlify
gatsby-plugin-netlify-cms
A Gatsby plugin which generates the Netlify CMS single page app
netlify-plugin-gatsby-cache
Persist the Gatsby cache between Netlify builds for huge build speed improvements!
gatsby-adapter-netlify
Gatsby adapter for Netlify
A build plugin to integrate Gatsby seamlessly with Netlify
npm install @netlify/plugin-gatsby
Typescript
Module System
Min. Node Version
Node Version
NPM Version
plugin-gatsby: v3.8.4
Updated on Jun 06, 2025
plugin-gatsby: v3.8.3
Updated on Mar 13, 2025
plugin-gatsby: v3.8.2
Updated on Jan 21, 2025
plugin-gatsby: v3.8.1
Updated on Apr 17, 2024
plugin-gatsby: v3.8.0
Updated on Dec 04, 2023
plugin-gatsby: v3.7.2
Updated on Oct 09, 2023
TypeScript (81.83%)
JavaScript (17.25%)
CSS (0.51%)
Shell (0.41%)
Total Downloads
0
Last Day
0
Last Week
0
Last Month
0
Last Year
0
MIT License
97 Stars
706 Commits
19 Forks
5 Watchers
57 Branches
29 Contributors
Updated on Jul 14, 2025
Latest Version
3.8.4
Package Id
@netlify/plugin-gatsby@3.8.4
Unpacked Size
121.98 kB
Size
31.85 kB
File Count
22
NPM Version
11.3.0
Node Version
24.1.0
Published on
Jun 06, 2025
Cumulative downloads
Total Downloads
Last Day
0%
NaN
Compared to previous day
Last Week
0%
NaN
Compared to previous week
Last Month
0%
NaN
Compared to previous month
Last Year
0%
NaN
Compared to previous year
17
2
The Essential Gatsby build plugin enables caching of builds, SSR and DSG render modes, image CDN and Gatsby Functions. It is installed automatically for all new Gatsby sites.
Note:
- Essential Gatsby includes functionality from the Gatsby Cache build plugin. If you already have the Gatsby Cache plugin installed on your Netlify site, you should remove it before installing this plugin.
- Essential Gatsby is not compatible with the Gatsby community plugin gatsby-plugin-netlify-cache.
Gatsby sites need two plugins to support all features.
@netlify/plugin-gatsby
. This is installed automatically for all Gatsby
sites deployed to Netlify.gatsby-plugin-netlify
. This needs to be manually
installed.New Gatsby sites on Netlify automatically install the Essential Gatsby build plugin. You can confirm this in the build logs. If you need to install it manually, you have two options:
The Netlify UI. Here, you can search for "Essential Gatsby" and install the plugin.
File-based plugin installation.
You can install the plugin as @netlify/plugin-gatsby
in your netlify.toml
file.
You should also install the Gatsby plugin gatsby-plugin-netlify. This is required for SSR and DSG pages, and adds support for Gatsby redirects and asset caching rules:
1npm install -D gatsby-plugin-netlify
gatsby-config.js
file:1module.exports = { 2 plugins: ['gatsby-plugin-netlify'], 3}
See the gatsby-plugin-netlify docs for more information, including optional plugin configuration.
In order to support Gatsby Functions and DSG and SSR render modes, this plugin
generates four Netlify Functions called __api
, __ssr
, __dsg
and _ipx
. If
you are not using any of these modes, then you can disable the creation of these
functions. If you are using the latest version of gatsby-plugin-netlify
then
this will be handled automatically, disabling functions if the site has no
Gatsby Functions, or DSG/SSR pages. Otherwise, you can do this manually by
setting the environment variable NETLIFY_SKIP_GATSBY_FUNCTIONS
to true
. Be
aware that if you do this, any DSG or SSR pages will not work, and nor will any
Gatsby Functions or the remote image CDN.
Gatsby includes beta support for deferred image resizing using a CDN. Netlify includes full support for Image CDN on all plans. For details on how to enable it, see the image CDN docs.
Currently you cannot use StaticImage
or gatsby-transformer-sharp
in SSR or
DSG pages. Support for Gatsby Image CDN is coming soon. The best workaround is
to use an image CDN such as
Cloudinary
or imgix to host your images. This will give
you faster builds and rendering too.
When developing Gatsby Functions it is usually easier to use the built-in
gatsby develop
functions server. However if you want to try the Netlify
functions wrapper it will run via netlify dev
. You should be sure to run
netlify build
first, so that the wrappers are generated and the functions
copied across.
In order to use Netlify Background or Netlify Scheduled Functions in your Gatsby project, you will need to create a netlify/functions
directory at the root of the project, and put the Functions in there.
Once that's completed, the Background or Scheduled Function can be invoked like an ordinary Gatsby function.
No vulnerabilities found.
Reason
30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10
Reason
no dangerous workflow patterns detected
Reason
no binaries found in the repo
Reason
license file detected
Details
Reason
packaging workflow detected
Details
Reason
security policy file detected
Details
Reason
dependency not pinned by hash detected -- score normalized to 3
Details
Reason
detected GitHub workflow tokens with excessive permissions
Details
Reason
no effort to earn an OpenSSF best practices badge detected
Reason
project is not fuzzed
Details
Reason
SAST tool is not run on all commits -- score normalized to 0
Details
Reason
58 existing vulnerabilities detected
Details
Score
Last Scanned on 2025-07-07
The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.
Learn More