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

# Update Row

> The Update Row tool step allows you to update any row in your Google Sheet

## Add the ‘Update Row’ Tool step to your Tool

<div
  style={{
position: "relative",
boxSizing: "content-box",
maxHeight: "100vh",
width: "100%",
aspectRatio: "1.8057022175290391",
padding: "24px 0"
}}
>
  <iframe
    src="https://app.supademo.com/embed/cmdy38zor86g29f96trqqyfz1?embed_v=2&utm_source=embed"
    loading="lazy"
    title="Google Sheets Update Row"
    allow="clipboard-write; fullscreen"
    webkitAllowFullscreen="true"
    mozAllowFullscreen="true"
    allowFullscreen
    style={{
  position: "absolute",
  top: 0,
  left: 0,
  width: "100%",
  height: "100%",
  border: "3px solid #5E43CE",
  borderRadius: "10px",
  objectFit: "cover"
}}
  />
</div>

You can add the ‘Update Row’ Tool step to your Tool by:

1. Creating a new Tool, then searching for the ‘Update Row’ Tool step
2. Click ‘Expand’ to see the full Tool step
3. Using the dropdown menu:
   * Select the Google account you would like to use.
   * Select the Drive you would like to use (defaults to "My Drive").
   * Select the Spreadsheet you would like to update.
   * Select the worksheet you would like to update.
4. Select the row number you would like to update.
5. Select whether the first row has headers.
6. Enter the values you would like to update.
7. Click 'Run step' to test out the Tool

## Using in an Agent

There are 3 ways to configure the tool step when using in an agent

<Tabs>
  <Tab title="Using dropdown menus">
    This is the easiest way to configure the tool step. You can select the Drive, Spreadsheet and Worksheet from a list of options via the dropdown menu.

    <img src="https://mintcdn.com/relevanceai/fLFlffrslASJvpw0/images/gs-update-row-eg-1.png?fit=max&auto=format&n=fLFlffrslASJvpw0&q=85&s=a2cfbcd4829c8744b83ccbfb57a713c7" alt="Google Sheets Update Row" width="1644" height="1460" data-path="images/gs-update-row-eg-1.png" />
  </Tab>

  <Tab title="Using input variables">
    This option offers the most flexibility - you can use the same tool step for multiple Google Sheets, however you will need to manually provide the necessary Google Sheet IDs.

    <img src="https://mintcdn.com/relevanceai/fLFlffrslASJvpw0/images/gs-update-row-eg-2.png?fit=max&auto=format&n=fLFlffrslASJvpw0&q=85&s=a0731f3c8206bb3c741e217bc4c6aa8e" alt="Google Sheets Update Row" width="1628" height="1466" data-path="images/gs-update-row-eg-2.png" />
  </Tab>

  <Tab title="Mix of dropdown menus and input variables">
    This option offers the best of both worlds. You can use the dropdown menu to select the Drive, Spreadsheet and Worksheet, and then use an input variable for "Row Number" and "Values" to allow the agent to dynamically update different rows in your Google sheet.

    <img src="https://mintcdn.com/relevanceai/fLFlffrslASJvpw0/images/gs-update-row-eg-3.png?fit=max&auto=format&n=fLFlffrslASJvpw0&q=85&s=4a047e96294f797cb0e6f8ce0aa6bac9" alt="Google Sheets Update Row" width="1650" height="1380" data-path="images/gs-update-row-eg-3.png" />
  </Tab>
</Tabs>

## Parameters

<ParamField path="Drive" type="string">
  The Drive you want to use. By default, the tool uses "My Drive".
</ParamField>

<ParamField path="Spreadsheet ID" type="string" required>
  To get the spreadsheet ID, navigate to your Google Sheet and copy the ID from the URL (the long string between `/d/` and `/edit`).
  <Tip> [You can use this tool to parse the worksheet, spreadsheet and drive IDs from a url](https://app.relevanceai.com/notebook/f1db6c/d64db999bc25-4ea0-b926-30b350f69243/01e4918b-6c0a-423d-8daa-a625ced25e23)</Tip>
</ParamField>

<ParamField path="Worksheet ID" type="string" required>
  To get the worksheet ID, open the specific worksheet you want to use and copy the ID from the URL (appears after `#gid=`).
  <Tip> [You can also use this tool to parse the worksheet, spreadsheet and drive IDs from a url](https://app.relevanceai.com/notebook/f1db6c/d64db999bc25-4ea0-b926-30b350f69243/01e4918b-6c0a-423d-8daa-a625ced25e23)</Tip>
</ParamField>

<ParamField path="Row Number" type="number" required>
  The row number you want to update.
</ParamField>

<ParamField path="Does the first row have headers?" type="boolean">
  When this option is checked, each column will appear as a separate input field in the tool step for you to fill in. **This option will be ignored when using dynamic input fields**.
</ParamField>

<ParamField path="Values" type="array" required>
  The data being inserted will need to be in an array format.
  <Note>Example: `["John Doe", "john.doe@example.com", "123 Main St"]`</Note>
</ParamField>

## Frequently asked questions (FAQs)

<AccordionGroup>
  <Accordion title="What is the difference between using the green input variables and the dropdown menu?">
    **The dropdown menu is the easiest way to configure the tool step**. You can select the Drive, Spreadsheet and Worksheet from a list of options via the dropdown menu.

    **The input variables offer more flexibility** e.g. you can use the same tool step for multiple Google Sheets, however you will need to manually provide the necessary Google Sheet IDs.
  </Accordion>

  <Accordion title="Can I use a mix of both dropdown menu and green input variables?">
    If you are using the tool in an agent, this is the recommended approach. You can use the dropdown menu to select the fields that don't need to change, and then use the green input variables for "Range" to allow the agent to dynamically retrieve data from your Google sheet.

    <Warning>If you are only using the input variables, you will need to provide the necessary Google Sheet IDs for the tool step to function properly. At the minimum, this includes the spreadsheet ID and the worksheet ID.</Warning>
  </Accordion>
</AccordionGroup>
