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

# Google Drive

> Import documents and photos from your Google Drive into any project.

## Enable and use the Google Drive connector

The Google Drive connector pulls documents and photos from Drive into a project. Unlike other connectors, **the connection is per person** — each teammate connects their own Google account and browses their own Drive; no Administrator needed. Access is **read-only**: XBuild copies files you pick and never changes or deletes anything in Drive. Connectors are included starting with XBuild Operator.

### 1. Connect Your Google Account

1. From the chat prompt, click **+** and select **Google Drive** (subtitle: *"Add documents and photos from your Drive"*) — or go to **Settings → Connectors → Google Drive**.
2. Click **Connect**. A secure window opens on Google's sign-in page; XBuild never sees your Google password.
3. Sign in, review the read-only permission, and allow access.
4. You're returned to XBuild with the connection active. The picker header shows which Google account is connected.

Each teammate who wants to import from their own Drive repeats these steps.

### 2. Import Files into a Project

Once connected, the **+** menu's Google Drive entry opens the file picker in any chat.

1. The picker opens with your **most recently viewed** files. Use **Search your Drive...** for anything else — it covers My Drive, shared drives, and files shared with you. Each row shows name, type, and size, with thumbnails for photos; Google-native files (Docs, Sheets, Slides) are listed too.
2. Click files to select or deselect. Files already imported into this project are pre-marked, so you won't create duplicates. The footer shows a running count and total size.
3. Click **Add \[N] files**. Added files sit in the compose area as attachments — remove one with the **×** on its chip, add more, and type your prompt. The import happens when you send; if you close the chat without sending, your selection is kept until you send or remove it.

| Limit (per import) | Size |
| - | - |
| Photos | 50 MB each |
| Other files | 500 MB each |
| Total | 2 GB |

A file over its limit is greyed out with the reason in its row and can't be selected.

### 3. What Happens After You Import

| File type | Lands as |
| - | - |
| Photos | Project photos — scanned, with AI titles and [descriptions](/features/photo-descriptions) |
| Documents | Project files the AI reads when building your [estimate](/features/creating-an-estimate) or proposal |
| Google Docs and Slides | PDFs |
| Google Sheets | Excel files |

XBuild copies the files — nothing links back to Drive, and later changes in Drive don't alter the project's copy. Picking a file again after it changed in Drive refreshes the project's copy instead of creating a duplicate.

### 4. Disconnect

Remove your connection from **Settings → Connectors → Google Drive**. Disconnecting revokes XBuild's access with Google and affects only your own connection; imported files stay on their projects. You can also revoke access from your Google account's third-party access settings — XBuild asks you to reconnect next time.

### 5. Troubleshooting Common Issues

* **The picker says my Google Drive access expired.** Connections can expire or be revoked from the Google side. Click the reconnect prompt in the picker (or go to **Settings → Connectors → Google Drive**) and sign in again. Nothing already imported is affected.
* **A teammate connected Google Drive but I can't use it.** Connections are per person — connect your own Google account.
* **A file I can see in Drive isn't in the picker.** The picker opens with recently viewed files — use the search bar. If it still doesn't appear, confirm the Google account in the picker header is the one that can see the file.
* **A file is greyed out.** It's over the size limit for its type — the row shows the reason.
* **My Google Doc imported as a PDF.** Expected — Docs and Slides become PDFs, Sheets become Excel files.

For further assistance with your Google account, visit [Google Drive Help](https://support.google.com/drive/). For XBuild-side issues, contact XBuild Support at [support@x.build](mailto:support@x.build).


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