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

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Add item

> Add a question, grid, section, text block, image, or video to a Google Form.

`addItem` appends or inserts any supported Forms item.

## Example

```ts theme={null}
import { automation, onHttpRequest } from "automate.ax"
import { addItem } from "automate.ax/google-forms"

export default automation("Add a survey section", () => {
  onHttpRequest({ scope: "automation" })

  addItem({
    form: "form-id",
    item: {
      type: "grid",
      title: "Rate the product",
      gridType: "multipleChoice",
      columns: ["Poor", "Good", "Excellent"],
      rows: [{ title: "Speed", required: true }, { title: "Reliability" }],
    },
  })
})
```

## Inputs

`form` and `item` are required. `position` is a one-based insertion position;
omit it to append. `requiredRevisionId` enables optimistic concurrency.

## Item types

* `question`: `title`, optional `description`/`grading`, and a typed `question`
  from [Add question](/reference/integrations/google-forms/actions/add-question#inputs).
* `grid`: `columns`, `gridType: "multipleChoice" | "checkbox"`, and rows with
  `title`, optional `required` and `questionId`; `shuffleRows` is optional.
* `pageBreak` or `text`: optional `title` and `description`.
* `image`: public `sourceUrl`, optional `altText`, `alignment`, `width` 1–740,
  title, and description.
* `video`: YouTube `youtubeUrl`, optional `caption`, `alignment`, `width` 1–740,
  title, and description.

`account` optionally selects the Google account binding.

## Output

Returns the complete updated `Form`, including provider-generated IDs. Images
must be reachable by Google and videos must use a YouTube watch or share URL.