# Insert a new row at the top of a sheet — Google Sheets

Botize method — `gspreadsheet.add_row` (action).

Move rows in a sheet to insert a new row at the beginning, allowing you to specify the values that each of the columns will take.

This is an action: it runs as a step of a task. Several can be chained.

## Fields you set

The field's internal name, its type and the values it accepts. These fields accept `{{...}}` tags from earlier steps.

- `mb_switch` *(boolean)* — Rules
- `sheet_url` *(string)* — URL of your sheet document
- `sheet` *(string)* — Sheet. Sheet id (gid) chosen from the list, or the sheet name. Empty = first sheet.
- `column_1` *(string)*
- `value_1` *(string)*
- `column_2` *(string)*
- `value_2` *(string)*
- `column_3` *(string)*
- `value_3` *(string)*
- `column_4` *(string)*
- `value_4` *(string)*
- `column_5` *(string)*
- `value_5` *(string)*
- `column_6` *(string)*
- `value_6` *(string)*
- `column_7` *(string)*
- `value_7` *(string)*
- `column_8` *(string)*
- `value_8` *(string)*
- `column_9` *(string)*
- `value_9` *(string)*
- `column_10` *(string)*
- `value_10` *(string)*
- `column_11` *(string)*
- `value_11` *(string)*
- `column_12` *(string)*
- `value_12` *(string)*
- `column_13` *(string)*
- `value_13` *(string)*
- `column_14` *(string)*
- `value_14` *(string)*
- `column_15` *(string)*
- `value_15` *(string)*
- `column_16` *(string)*
- `value_16` *(string)*
- `column_17` *(string)*
- `value_17` *(string)*
- `column_18` *(string)*
- `value_18` *(string)*
- `column_19` *(string)*
- `value_19` *(string)*
- `column_20` *(string)*
- `value_20` *(string)*
- `column_21` *(string)*
- `value_21` *(string)*
- `column_22` *(string)*
- `value_22` *(string)*
- `column_23` *(string)*
- `value_23` *(string)*
- `column_24` *(string)*
- `value_24` *(string)*
- `column_25` *(string)*
- `value_25` *(string)*
- `column_26` *(string)*
- `value_26` *(string)*
- `column_27` *(string)*
- `value_27` *(string)*
- `column_28` *(string)*
- `value_28` *(string)*
- `column_29` *(string)*
- `value_29` *(string)*
- `column_30` *(string)*
- `value_30` *(string)*
- `column_31` *(string)*
- `value_31` *(string)*

It also accepts repeatable field groups, with these prefixes: `mb_filters_*`. These are composite components (buttons, filters, keyboards); the trailing number is set by the user as they are added.

## Output variables

Data this step makes available. Reference them in later steps with the double-brace tag.

- `{{_status}}` *(text)* — _status

## Account

Needs a connected Google Sheets account in Botize: https://botize.com/en/app/gspreadsheet/authenticate

## This app

Every trigger and action for Google Sheets: https://botize.com/en/app/gspreadsheet.md

## How to build this

An AI assistant (Claude, ChatGPT, Cursor…) can create and edit these tasks in the user's account through the Botize MCP connector, included in every plan:

    https://webhook.botize.es/mcp

- Connection guide: https://botize.com/en/mcp
- Agent map: https://botize.com/llms.txt
- New account: https://botize.com/en/join (500 free operations, no card)

---
Machine-readable summary for AI assistants. Human version: https://botize.com/en/method/gspreadsheet/add_row