Skip to main content

Delete Row

Deletes or clears a row at the specified position in the active sheet.

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 the node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

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

Input

  • File Descriptor - File descriptor of the Excel file. This is the identifier returned by the Open Excel node.
  • Row Number - Row number to delete or clear (1-based index).

Output

This node has no output.

Options

  • Clear - Determines the deletion behavior. Default is false.
    • false - Deletes the entire row (rows below shift up)
    • true - Clears the row content only (row structure remains, cells are emptied)

Example

Deleting a row (shifts rows up):

// File Descriptor: message.excel_fd
// Row Number: 5
// Clear: false
// Row 5 is deleted, rows 6 and below shift up

Clearing a row (keeps row structure):

// Row Number: 3
// Clear: true
// Row 3 is emptied but remains in place

Removing header row:

// Row Number: 1
// Clear: false
// Deletes the first row

Clearing multiple rows:

// Loop through rows to clear
// Row Number: message.row_index
// Clear: true

Tips

  • When Clear is false, the row is completely removed and rows below shift up.
  • When Clear is true, only the content and formatting are removed; the row structure stays.
  • Use Clear: false to remove unwanted rows and compact your data.
  • Use Clear: true to reset a row for reuse while maintaining the structure.
  • Row indices are 1-based (row 1 is the first row).
  • Be careful when deleting rows in loops - indices change as rows are deleted.

Common Errors

ErrorSolution
Row Number must be greater than 0Provide a valid row number (1 or higher)
Invalid File DescriptorEnsure the Open Excel node was executed first