Skip to main content

Clear Range

Clears a range of data in a Google Spreadsheet.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs​

  • Spreadsheet Id - The ID of the Google Spreadsheet where the data range will be cleared.
  • Start Cell - The starting cell of the range to clear (e.g., "A1").
  • End Cell - The ending cell of the range to clear (e.g., "Z100").

Options​

No additional options available for this node.

Output​

No output variables for this node.

How It Works​

The Clear Range node removes all data from a specified range in a Google Spreadsheet. When executed, the node:

  1. Validates all input parameters
  2. Connects to the Google Spreadsheet using the provided ID
  3. Constructs a range reference based on the Start Cell and End Cell inputs
  4. Sends a clear values request to remove all data within the specified range
  5. Returns any errors encountered during the process

Requirements​

  • A valid Google Spreadsheet ID
  • Valid cell references for the range (Start Cell and End Cell)
  • Proper Google Sheets API authentication and permissions

Error Handling​

The node will return specific errors in the following cases:

  • Empty or invalid Spreadsheet Id
  • Empty or invalid Start Cell reference
  • Empty or invalid End Cell reference
  • Invalid cell reference format
  • Google Sheets API authentication or permission errors
  • Network or connectivity issues with Google Sheets API

Usage Notes​

  • The Spreadsheet Id can be obtained from the URL of your Google Spreadsheet or from the Open Spreadsheet node
  • Both Start Cell and End Cell must be specified to define the range
  • All data within the specified range will be permanently cleared
  • Formatting within the range is preserved, only cell values are cleared
  • This operation modifies the spreadsheet data, so use with caution
  • Ensure your Google account has proper permissions to modify the target spreadsheet