Starbase / 02 RecipeAgents

RecipeAgents / n8n nodes / Google Sheets

Node reference · data pulled Oct 26, 2026

n8n Google Sheets node: what the data shows

Reads, appends, updates and deletes rows, and manages sheets, in Google Sheets.

4,846public templates use it (35.7% of 13,574)
58.3%of those also contain an AI node
52.2score out of 80 · rank 14 of 22
204commits to its source folder on GitHub

What it does

It works on two things: whole spreadsheet documents and the sheets inside them. Most templates use it as a lightweight database: append a row per lead or invoice, look rows up, or update one by a matching column. It connects with a Google OAuth2 credential or a service account.

It is the most used app node in the library, and Gmail is one of its strongest partners: more than a third of Sheets templates also send or read email.

How often public templates use it

4,846 of the 13,574 public templates on n8n.io (35.7%) contain this node, in the snapshot we took on 2026-10-20. The table splits that by the year each template was published. 2026 runs to October 20.

Year publishedTemplates with the nodeShare of that year
202462 of 46213.4%
20252,174 of 6,56433.1%
20262,556 of 5,84543.7%

The median template using this node has 150 views on n8n.io, against 284 for all templates. Template counts show what people publish, not what runs in production.

What it is used with

The most frequent partners are the nodes that appear most often in the same templates. "Lift" compares that with the whole library: 2× means the partner turns up twice as often next to this node as in an average template.

Most frequent partnerShare of its templatesLift
Code70.6%1.19×
If59.0%1.17×
Edit Fields (Set)57.1%1.03×
HTTP Request52.7%1.02×
Schedule Trigger41.1%1.29×
Gmail34.2%1.52×

Strong pairings (in at least 5% of its templates, lift 1.5× or more): 2. The top ones:

Strong partnerShare of its templatesLift
Limit5.3%1.52×
Gmail34.2%1.52×

Most viewed public templates that use it: Fully automated ai video generation and multi platform publishing (402,403 views); Generate ai viral videos with seedance and upload to tiktok youtube and instagram (349,477 views); Generate ai viral videos with veo 3 and upload to tiktok (305,790 views).

Versions and changes

Node versions from the npm packages n8n-nodes-base and @n8n/n8n-nodes-langchain, version 2.44.4. New workflows get the default version; workflows built earlier keep the version they were built with until you replace the node.

NodeVersionsDefaultCredential typesScope
Google Sheets1, 2, 3, 4, 4.1, 4.2, 4.3, 4.4, 4.5, 4.6, 4.74.7Google service account, Google Sheets OAuth22 resources, 10 operations

Source on GitHub: packages/nodes-base/nodes/Google/Sheet: 204 commits since 2020-05-30, last on 2026-10-20.

Recent fixes and features

  • 2026-05-25: fix(Google Sheets Node): Handle undefined lookup values in lookupValues (PR #31055)
  • 2026-05-20: fix(Google Sheets Node): Allow column reorder and insertion without erroring (PR #30621)
  • 2026-05-06: fix(Google Sheets Node): Reduce duplicate API calls in append operation to avoid quota limits (PR #29444)
  • 2025-09-22: fix(Google Sheets Node): Add a warning about using expressions (PR #19840)
  • 2025-08-01: fix(Google Sheets Node): Make it possible to set cell values empty on updates (PR #17224)
  • 2025-07-28: fix(Google Sheets Node): Get Rows operation returns an empty string when the cell has a value of 0 (PR #17642)

Merged dates from GitHub. A fix only helps once your n8n instance runs a release that includes it, so check your version.

Known problems

  • Appending an array. A field holding an array won't append as rows. Split it first with Split Out, or reshape it with Code. Source: n8n docs
  • Renamed columns. If you rename sheet columns after setting the node up, re-select the column mapping mode so it re-reads the headers. Source: n8n docs
  • Zero read as empty. Get Rows returned an empty string for cells holding 0 until a July 2025 fix. Source: n8n PR #17642
  • Quota errors on append. A 2026 fix cut duplicate API calls during append that could exhaust Google's quota. Source: n8n PR #29444

Forum trouble signal: not measured. The n8n community forum's terms forbid automated access, so we don't count forum threads.

Our recipes that use it

9 of our 25 importable workflows use this node:

Official docs and sources

Usage, pairings, AI share and views: our count of 13,574 public n8n.io templates (snapshot 2026-10-20). Versions: npm packages, version 2.44.4. Changes: n8n's GitHub repository. Docs read and data pulled Oct 26, 2026. We describe each node in our own words; the docs are the authority on settings.

Related nodes

Questions

How many n8n templates use the Google Sheets node?
4,846 of the 13,574 public templates on n8n.io (35.7%), in our snapshot of 2026-10-20.
What is the Google Sheets node most often used with?
Code, which appears in 70.6% of its templates. The most distinctive partner is Limit (lift 1.5×).
Can I use Google Sheets as a database in n8n?
For small volumes, yes: append, look up and update rows. Google's API quotas and the lack of locking make it a poor fit for high-volume writes.
Service account or OAuth?
Both work. A service account suits server-side automations; remember to share the sheet with the service account's email.
Newsletter

One small automation every Friday

Each Friday email has one recipe, the prompt for it, and the way it broke when we wrote it up. It's free, and every email has an unsubscribe link.