Skip to main content
Version: Current

Insert Rows

Description​

Inserts one or more rows into a Google Sheet.

Existing rows are shifted downward to accommodate the newly inserted rows.

Common Capabilities​

Process Data Support​

info

This activity supports dynamic configuration using variables from the Process Data drawer.

You can bind values from Model Data, Form Data, System Data, Enterprise Variables, and Activity Outputs.

Learn more → Using Process Data

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.

info

For details about selecting spreadsheets and sheets, see Google Sheets Data Selection.

Wait All Incoming​

Execution Control

Controls how this activity behaves when multiple incoming execution paths converge.

Determines whether the activity executes when:

  • Any incoming path completes, or
  • All relevant incoming paths complete before execution

Learn more → Execution Control

On Error​

Error Handling Strategy

Defines how the workflow behaves if this activity encounters a runtime error.

Supported strategies include:

  • Fault
  • Continue
  • Suspend
  • Retry

Learn more → Error Handling

Output​

Result​

A Boolean value indicating whether the insert operation completed successfully.

ValueMeaning
TrueThe specified rows were successfully inserted.
FalseThe 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.