Migrate to Netlify Today

Netlify announces the next evolution of Gatsby Cloud. Learn more

ContactSign Up
Community Plugin
View plugin on GitHub


NOTE: This package was originally forked from gatsby-source-google-sheets.

This package was forked and retooled with an upgraded google-spreadsheet module that uses Google Sheets API v4, as v3 will be officially retired January 26th, 2021.

V2: this package has been updated to work with Gatsby v3. For Gatsby v2 and under, please see v1.

This source plugin for Gatsby JS will turn any Google Sheets worksheet into a GraphQL type for build-time consumption.

How to:

Step 1: set up sheets/permissions

  1. Create a Google Service Account and download the credentials file.
  2. Open your google sheet, click “File > Share…” and enter your service account’s e-mail address (you can find it in the credentials file).

Step 2: configure your gatsby project

Standard source plugin installation.

yarn add @cezarcarvalhaes/gatsby-source-google-sheets

// gatsby-config.js
// ...
    resolve: 'gatsby-source-google-sheets',
    options: {
        spreadsheetId: 'get this from the sheet url',
        worksheetTitle: 'ie the name in the worksheet tab',
        credentials: require('./path-to-credentials-file.json')
// ...

The plugin makes the following conversions before feeding Gatsby nodes:

  1. Numbers are converted to numbers. Sheets formats numbers as comma-delineated strings, so to determine if something is a number, the plugin tests to see if the string (a) is non-empty and (b) is composed only of commas, decimals, and digits:
if (
    "value".replace(/[,\.\d]/g, "").length === 0 
      && "value" !== ""
   ) { 
    ...assume value is a number and handle accordingly
  1. “TRUE”/“FALSE” converted to boolean true/false
  2. empty cells ("" in sheets payload) converted to null
  3. Column names are converted to camelcase via lodash _.camelCase() (see note 2 in ‘A few notes’)

A few notes:

  1. Not tested with cells of data type dates.
  2. Google sheets mangles column names and converts them all to lower case. This plugin will convert them to camelcase, so the best convention here is to name your columns all lowercase with dashes. e.g. instead of “Column Name 1” or “columnName1”, prefer “column-name-1”—this last one will be turned into “columnName1” in your GatsbyQL graph.


  1. If you get the error “No key or keyFile set”, make sure you are using a Service Account API key and not a simple API key.
  2. If you get the error “Cannot read property ‘worksheets’ of undefined”, make sure you have shared your spreadsheet with your service account user.
© 2023 Gatsby, Inc.