Skip to main content
Version: Current

Insert Columns

Description​

Inserts one or more columns into a Google Sheet.

Existing columns are shifted to the right to accommodate the newly inserted columns.

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 columns 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 column or a range of columns will be inserted.

Column Letter​

The column at which the new column will be inserted.

Required when Selection Type is set to Single.

From​

The starting column of the range to insert.

Required when Selection Type is set to Multiple.

To​

The ending column of the range to insert.

Required when Selection Type is set to Multiple.

Inherit Previous Formatting​

Determines whether newly inserted columns inherit formatting from the column immediately preceding them.

When enabled, formatting such as cell styles, fonts, colors, borders, number formats, and alignment is copied to the inserted columns.

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 columns were successfully inserted.
FalseThe insert operation was unsuccessful.

Remarks​

  • The authenticated Google account must have permission to modify the spreadsheet.
  • Inserting columns shifts existing columns to the right.
  • When multiple columns are inserted, all columns within the specified range are created.
  • When Inherit Previous Formatting is enabled, formatting from adjacent columns is applied to the inserted columns.
  • Existing formulas, references, charts, and dependent calculations may be adjusted automatically by Google Sheets.