Gatsby Book Launch

“The missing guide to the modern web” launches on Thursday, Sep 29th: Modular: The Web’s New Architecture

ContactSign Up for Free
Community Plugin
View plugin on GitHub


A Gatsby plugin that extends the default ESLint configuration.


This plugin supports almost all rules added by the default configuration. Some rules are temporarily disabled. Please refer to these issues for more information.


npm i -D eslint-plugin-gatsby@npm:gatsby-plugin-eslint-config
yarn add -D eslint-plugin-gatsby@npm:gatsby-plugin-eslint-config

Installing eslint-plugin-gatsby@npm:gatsby-plugin-eslint-config sets eslint-plugin-gatsby as an alias for this plugin. This is done so that the plugin can be imported into .eslintrc.js.



module.exports = {
  plugins: ["gatsby"],
  extends: ["plugin:gatsby/recommended"],


module.exports = {
  plugins: [
      resolve: "eslint-plugin-gatsby",
      options: {
        extensions: ["js", "jsx", "ts", "tsx"],
        failOnError: false,

Refer to the complete list of options.

© 2022 Gatsby, Inc.