Insert Rows
Description
Inserts one or more rows into a Google Sheet.
Existing rows are shifted downward to accommodate the newly inserted rows.
Common settings
Use Process Data to bind supported inputs to workflow values or upstream outputs. See Common Activity Features for shared execution, error-handling, and output-persistence settings. Availability depends on the activity.
Design-Time Configuration
Display Text
A user-defined name for the activity, displayed on the workflow canvas to help identify its purpose.
Connection Name
The configured Google Sheets connection used to access Google Sheets resources.
Spreadsheet
The spreadsheet where the rows will be inserted.
Sheet Name
The name of the sheet where the operation will be performed.
If not specified, the currently active sheet is used.
Selection Type
Determines whether a single row or a range of rows will be inserted.
Row Number
The row at which the new row will be inserted.
Required when Selection Type is set to Single.
From
The starting row of the range to insert.
Required when Selection Type is set to Multiple.
To
The ending row of the range to insert.
Required when Selection Type is set to Multiple.
Inherit Previous Formatting
Determines whether newly inserted rows inherit formatting from the rows immediately preceding them.
When enabled, formatting such as cell styles, fonts, colors, borders, and alignment is copied to the inserted rows.
For details about selecting spreadsheets and sheets, see Google Sheets Data Selection.
Execution settings
Configure Wait All Incoming when execution paths converge, and On Error for failure handling. Select Inherit where available to use the workflow-level error policy.
Output
Result
A Boolean value indicating whether the insert operation completed successfully.
| Value | Meaning |
|---|---|
| True | The specified rows were successfully inserted. |
| False | The insert operation was unsuccessful. |
Remarks
- The authenticated Google account must have permission to modify the spreadsheet.
- Inserting rows shifts existing rows downward.
- When multiple rows are inserted, all rows within the specified range are created.
- When Inherit Previous Formatting is enabled, formatting from adjacent rows is applied to the inserted rows.
- Existing formulas, references, charts, and dependent calculations may be adjusted automatically by Google Sheets.
Example: Select a contiguous group
Choose Multiple and set From to 2 and To to 4. This selects three rows, including both endpoints. New rows are inserted at the selected positions and existing rows shift to make room.
At the first row or column, Inherit Previous Formatting cannot use a preceding position; the operation uses the following position instead. A successful operation returns Result = True. Validation, permission, and service failures raise activity errors; handle them with On Error rather than relying only on a False result.