Google Sheets Write
Write and update data in Google Sheets programmatically
Node Type
Action
Category
Google Sheets Integration
Icon
Google Sheets
Overview
The Google Sheets Write node allows you to write, update, and append data to Google Sheets programmatically. This powerful automation tool integrates with Google Sheets API to provide intelligent data management capabilities for your workflows.
Key Features
- • Flexible Data Writing: Write to specific ranges, append rows, or update cells
- • Batch Operations: Handle multiple updates efficiently
- • Data Validation: Ensure data integrity before writing
- • Real-time Updates: Changes appear instantly in your sheets
- • Error Handling: Built-in success/failure tracking
Prerequisites
Google Integration
Must be connected to access Google Sheets API
Required Scopes
https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/drive.file
Node Configuration
Required Fields
spreadsheetId
The unique identifier of the Google Spreadsheet (found in the URL).
range
The range to write to (e.g., "Sheet1!A1" for a single cell or "Sheet1!A1:D10" for a range).
values
The data to write. Use 2D array format: [[row1], [row2], ...] for multiple rows.
Optional Fields
valueInputOption
How to interpret the input data. "RAW" writes as-is, "USER_ENTERED" processes formulas and formatting.
insertDataOption
Whether to insert new rows or overwrite existing data. Defaults to "OVERWRITE".
Examples & Use Cases
Basic Data Writing
Write a single row of data to a spreadsheet
{
"spreadsheetId": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms",
"range": "Sheet1!A1",
"values": [["John Doe", "[email protected]", "Active"]],
"valueInputOption": "USER_ENTERED"
}
Writes a single row with name, email, and status to the first row of Sheet1.
Appending Multiple Rows
Add multiple rows of data to the end of a sheet
{
"spreadsheetId": "{{workflowData.sheetId}}",
"range": "DataSheet!A:A",
"values": [
["Alice", "[email protected]", "Premium"],
["Bob", "[email protected]", "Standard"],
["Charlie", "[email protected]", "Premium"]
],
"insertDataOption": "INSERT_ROWS"
}
Appends three new rows to the DataSheet, inserting them as new rows.
Updating Specific Range
Update a specific range of cells with new data
{
"spreadsheetId": "{{config.sheetId}}",
"range": "Config!B2:D5",
"values": [
["Value1", "Value2", "Value3"],
["Value4", "Value5", "Value6"],
["Value7", "Value8", "Value9"],
["Value10", "Value11", "Value12"]
],
"valueInputOption": "RAW"
}
Updates a 3x4 range starting at B2 with new values, writing raw data without processing.
Workflow Examples
Data Collection Pipeline
Complete workflow for collecting and storing data
Workflow Structure
Step-by-Step Configuration
- Form Submission: Collect data from users or systems
- Data Validation: Validate and clean the input data
- Google Sheets Write: Store the validated data
- Confirmation: Send confirmation to users
Report Generation
Generate and store automated reports
Use Case
Automatically generate reports from various data sources, process them with AI, and store the results in Google Sheets for team access.
Implementation
- Collect data from multiple sources (APIs, databases, etc.)
- Process and analyze data with AI or business logic
- Format results into structured reports
- Write reports to designated Google Sheets
Best Practices
Do's
- • Validate data before writing to sheets
- • Use meaningful range names and sheet references
- • Implement error handling for write failures
- • Consider data size and API rate limits
- • Always check the success output field
- • Use appropriate value input options for your data
Don'ts
- • Don't write to sheets without proper permissions
- • Avoid overwriting important data without backup
- • Don't ignore API rate limits
- • Avoid writing large datasets in single operations
- • Don't assume write operations always succeed
- • Avoid writing sensitive data without encryption
Troubleshooting
Common Issues
Permission Denied
Symptoms: Node fails with access denied errors
Solution: Ensure Google integration has write access to the target spreadsheet
Invalid Range
Symptoms: Node fails with range not found errors
Solution: Verify the sheet name and range format (e.g., "Sheet1!A1")
Data Format Issues
Symptoms: Data appears incorrectly in sheets
Solution: Check the values array format and use appropriate valueInputOption