> ## Documentation Index
> Fetch the complete documentation index at: https://docs.browseract.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Send Bot Results to Google Sheets

Add Bot results as new rows or update matching rows in a worksheet.

## Before you start

* Use a published Agent-built Bot with a result table.
* Create a spreadsheet and worksheet; give the Google account edit access.
* Add column headers matching the Bot's result fields, such as `url`, `rank`, `price`, and `title`.

## 1. Connect Google Sheets

Open your Bot → **Integrations** → **Google Sheets → Configure**.

![Open Integrations and configure the Google Sheets destination](https://mintcdn.com/browseract/AUdLlmFpHCC88kix/images/integrations-google-sheets-01-integrations.png?fit=max\&auto=format\&n=AUdLlmFpHCC88kix\&q=85\&s=67ca8849744a7e29f2deb340640c60a7)

In **Account**, click **Authorize new account**. Composio, BrowserAct's integration partner, opens authorization in a new window.

![Authorize a new Google Sheets account](https://mintcdn.com/browseract/AUdLlmFpHCC88kix/images/integrations-google-sheets-02-authorize-account.png?fit=max\&auto=format\&n=AUdLlmFpHCC88kix\&q=85\&s=865d8b78faf41b81980046523a5a6006)

Click **Connect Account** and choose your Google account.

![Connect BrowserAct to Google Sheets through Composio](https://mintcdn.com/browseract/AUdLlmFpHCC88kix/images/integrations-google-sheets-03-connect-account.png?fit=max\&auto=format\&n=AUdLlmFpHCC88kix\&q=85\&s=5f4d7137c6b743300e392e356952832f)

Select both requested Google Drive and Google Sheets permissions, then click **Continue**.

![Select the requested Google Drive and Google Sheets permissions, then click Continue](https://mintcdn.com/browseract/AUdLlmFpHCC88kix/images/integrations-google-sheets-04-google-permissions.png?fit=max\&auto=format\&n=AUdLlmFpHCC88kix\&q=85\&s=7320fd74c4b6ee602b252c0eaec85dc6)

After authorization succeeds, return to BrowserAct.

![Successful Google Sheets account connection](https://mintcdn.com/browseract/AUdLlmFpHCC88kix/images/integrations-google-sheets-05-connection-success.png?fit=max\&auto=format\&n=AUdLlmFpHCC88kix\&q=85\&s=3368b60dab11b1b33fcc3be4ea8fab11)

Confirm **Connected**, then click **Next**.

![Confirm the connected account and continue](https://mintcdn.com/browseract/AUdLlmFpHCC88kix/images/integrations-google-sheets-06-connected-account.png?fit=max\&auto=format\&n=AUdLlmFpHCC88kix\&q=85\&s=9a6d44dfe73eb61c83fd1d5a50590de1)

## 2. Select the worksheet and run sources

In **Destination**, choose your **Spreadsheet** and **Worksheet**. Refresh the list if either is missing.

Under **Runs to deliver**, select at least one source: **Manual runs**, **Scheduled runs**, **Runs from Make, n8n & Zapier**, or **API runs**. Click **Next**.

Only successful runs from selected sources deliver results. See [delivery conditions](https://docs.browseract.com/integrations/integration-overview.md?co-from=link-Docs#delivery-conditions) for exclusions.

![Select the spreadsheet, worksheet, and run sources](https://mintcdn.com/browseract/AUdLlmFpHCC88kix/images/integrations-google-sheets-07-destination.png?fit=max\&auto=format\&n=AUdLlmFpHCC88kix\&q=85\&s=db227309ea4e5346a56bcbe290e263e9)

## 3. Set the write mode and field mapping

In **Content**, map each **Bot output** field to its **Sheet column**.

### Add rows

Select **Add rows** to append each result as a new row.

![Choose Add rows and review the field mapping](https://mintcdn.com/browseract/AUdLlmFpHCC88kix/images/integrations-google-sheets-08-add-rows.png?fit=max\&auto=format\&n=AUdLlmFpHCC88kix\&q=85\&s=ffafb77b1f5de17cd82168dcf44ba9dc)

### Update existing rows

Select **Update existing rows** and choose **one mapped field** under **Match**, such as `url`.

![Choose Update existing rows and select one Match field](https://mintcdn.com/browseract/AUdLlmFpHCC88kix/images/integrations-google-sheets-09-update-rows.png?fit=max\&auto=format\&n=AUdLlmFpHCC88kix\&q=85\&s=353dd49fbc47c702190c69a25cb8f06a)

* Matching is exact, including capitalization and spaces.
* All matching rows are updated, using only mapped columns.
* Unmatched results and empty Match values are skipped; no new rows are added.
* Empty values in other mapped fields may clear existing cells.

## 4. Save and check delivery

Click **Save & enable**; saving does not send a test result. Run the Bot from a selected source, then check the worksheet for added or updated rows.

In **History**, hover over or keyboard-focus **Delivery** beside **Status** to check the Google Sheets result or error. A successful run can have a failed delivery. See [delivery statuses](https://docs.browseract.com/integrations/integration-overview.md?co-from=link-Docs#check-delivery).

## Troubleshooting

| Problem | Fix |
| - | - |
| Authorization fails | Allow the authorization window and select both requested Google permissions. |
| Spreadsheet or worksheet is missing | Create it first, check account access, then refresh the list. |
| Fields do not line up | Check worksheet headers, refresh columns, and review field mapping. |
| No rows are updated | Check the Match field and exact values. Unmatched results are skipped. |
| Nothing is delivered | Check Enabled, run success, selected source, and Delivery errors. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.