# Google Forms

> Run Orshot workflows when your Google Form gets a new response and turn submissions into images, PDFs, and videos automatically

- **URL**: https://orshot.com/docs/integrations/google-forms

---

## Introduction

The Google Forms integration lets a workflow run every time your form gets a new response. Each submission becomes a row of data (one field per question), so you can render personalized images, certificates, social graphics, PDFs, or videos from it and deliver them anywhere a workflow can: webhooks, Slack, Google Drive, your own storage, and more.

## Connect Google Forms

1. In Orshot, open **Integrations** from your workspace sidebar.
2. Find **Google Forms** and click **Connect**.
3. Approve access on Google's consent screen. Keep all the requested permissions checked, then you're returned to Orshot as **Connected**.

Only workspace **owners and admins** can connect or disconnect, and there's one connection per workspace.

## The workflow trigger

Add the **New Google Forms response** trigger to a workflow:

1. Create a workflow and pick **New Google Forms response** as the trigger.
2. Choose your form from the picker, or paste the form's **edit URL** (`docs.google.com/forms/d/FORM_ID/edit`). Share links (`/forms/d/e/...`) don't work here since Google's API can't read them.
3. Optionally enable **Process existing responses** to run the workflow for responses that were already submitted before you activated it.
4. Add your render and delivery steps, then activate.

Orshot checks the form for new responses on a schedule (how often depends on your plan). The trigger fires once per response, when it's first submitted; if a respondent later edits their response, the workflow doesn't run again.

## Response data

Each response arrives as a flat row your steps can map to template fields:

| Field | Description |
|---|---|
| `response_id` | Google's unique id for the submission. |
| `submitted_at` | When the response was submitted. |
| `respondent_email` | The respondent's email, when your form collects emails. Empty otherwise. |
| One field per question | Keyed by the question's title, e.g. `Your name`. |

A few details on how answers are flattened:

- Multiple-choice and checkbox answers with several selections are joined with commas.
- File upload answers use the uploaded file names.
- Grid questions (multiple-choice or checkbox grids) become one field per row, named like `Rate each feature - Speed`.
- Questions the respondent skipped come through as empty strings, so your field mappings stay stable.

## Notes

- Renders started by the workflow use your workspace's credits, like any other workflow run.
- The number of responses processed per check is capped by your plan.
- Disconnecting Google Forms stops any workflows that use the trigger until you reconnect.

## Need Help?

- Contact support at hi@orshot.com or use the chat button in your Orshot dashboard