---
title: Google Drive | Lightfield
description: Connect your Google Drive account to add Drive files and folders to records, and let the agent read them when you ask.
---

Connect your Google Drive account to add Drive files and folders to accounts, contacts, opportunities and custom object records. The files stay in Google Drive, and Lightfield shows them on the record’s **Files** tab so everyone working the record can find them.

## Who can use it

Google Drive connects per person: each person connects their own account under **Personal connection**, and no one, including an admin, can connect it for someone else. Owners, admins and members can add Drive files to the records they can edit. Viewers can open files on a record but can’t add any.

## Connect your Google Drive account

1. In Lightfield, go to **[Settings → Integrations → Google Drive](https://crm.lightfield.app/crm/settings/integrations/google-drive/)**.
2. Under **Personal connection**, click **Connect**, then choose your Google account and allow Lightfield to view your Drive files.
3. Back in Lightfield, the connection shows as **Connected**.

Lightfield only reads your Drive. It doesn’t create, change or delete anything in it, and nothing is added to a record until you choose it.

## Add Drive files and folders to a record

1. Open the account, contact, opportunity or custom object record and go to its **Files** tab.
2. Click **Add from Google Drive**. If you haven’t connected Drive yet, Lightfield opens the Google Drive settings page first; connect, then go back to the record.
3. In **Choose files or folders to add**, select up to 100 files or folders and confirm.

Lightfield shows **Added 1 item from Google Drive** (or how many you added), and the items appear on the **Files** tab and in the record’s **Activity log**. An item that’s already on the record shows **This item is already linked** instead.

When you add a folder, Lightfield brings in the files inside it and keeps them in sync with Drive, so files added to the folder later appear on the record too. The folder shows **Syncing…** while its file list loads. Folders with over 10,000 files sync only partly.

Click a file to open it in Google Drive, or a folder to see the files inside it.

## Who can see Drive files on a record

Everyone who can see a record sees the names of the Drive files and folders added to it. Opening a file uses your own Google Drive access, so if the file isn’t shared with you, Google asks you to request access. Check who can see the record before adding a file with a confidential name; see [Control who can see your data](/help/privacy-and-access/index.md).

## Ask the agent about Drive files

The agent can read the Drive files on a record’s **Files** tab through your own Drive connection, so it reads only files you can open. Ask it to summarize a proposal or pull numbers from a spreadsheet on an opportunity. Google Docs, Sheets and Slides are read as documents, spreadsheets and PDFs. A file type Google doesn’t export, such as a Form, can’t be read; the agent shares its link instead.

With your Drive connected, you can also ask the agent to search your Drive, read a file from its link, or add Drive files to a record or remove them, for example “Add the Acme MSA from my Drive to the Acme opportunity.” You need to be able to edit each record. The agent shows a card with the changes, and nothing changes until you approve it. Automations can use the same Drive steps, reading the Drive of the person they run as.

## Remove a file or disconnect Drive

- **Remove a file or folder from a record:** on the record’s **Files** tab, choose **Remove from record** on the item, then **Remove**. The file stays in Google Drive, and removing it from one record doesn’t remove it from others.
- **Disconnect your account:** in **[Settings → Integrations → Google Drive](https://crm.lightfield.app/crm/settings/integrations/google-drive/)**, open **More actions** next to the status under **Personal connection** and choose **Disconnect**. Files you added stay on their records. If no one else’s connection can reach a file, it shows **Drive disconnected. Reconnect a Drive with access to sync it.** until someone with access connects their Drive.

## Troubleshooting

### A Drive file on a record shows a warning

The status under the file says what’s wrong:

- **Trashed in Drive:** someone moved the file to the Drive trash. Restore it in Google Drive.
- **Deleted or no longer shared in Drive:** the file was deleted, or it’s no longer shared with anyone who connected Drive in Lightfield. Share it again or add the current copy.
- **No one here can open this now:** no one who connected Drive in your workspace has access to the file any more. Ask its owner to share it with you in Google Drive.
- **Drive disconnected. Reconnect a Drive with access to sync it.:** the Drive connection that synced the file was disconnected. Connect a Drive account that can open the file in **[Settings → Integrations → Google Drive](https://crm.lightfield.app/crm/settings/integrations/google-drive/)**.
- **Only part of this folder is synced (over 10,000 files):** add the subfolders you need instead of the whole folder.

### Add from Google Drive shows an error

If you see **Couldn’t add from Google Drive. Please try again.**, check that your Google Drive connection shows **Connected** in **[Settings → Integrations → Google Drive](https://crm.lightfield.app/crm/settings/integrations/google-drive/)**, and that the items you picked aren’t in the Drive trash. If the connection shows **Disconnected**, click **Reconnect**.
