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

# Google Drive Sync

> How to connect Google Drive, configure folder sync, and manage synced files in Equa

# Google Drive Sync

<Note>
  This page covers the **Equa platform's Data Room sync** feature. For agent-level Google Drive tools (list, search, upload, download, mkdir via MCP), see [Google Drive MCP](/tools/gdrive).
</Note>

Google Drive Sync lets you connect your Google account and automatically synchronize files from specific Google Drive folders into your Equa Data Room. This eliminates manual uploads for teams that already use Google Drive as their document store.

## Prerequisites

* Active Equa account with organization admin permissions
* A Google account with files you want to sync
* Google Drive integration enabled for your organization

## Connecting Google Drive

### Step 1: Navigate to Google Drive Settings

From your organization sidebar, click **Settings > Integrations > Google Drive**, or navigate to the Google Drive sync page.

### Step 2: Authorize Equa

Click **Connect Google Drive**. You will be redirected to Google's authorization page.

### Step 3: Grant Permission

Sign in to your Google account and grant Equa read-only access to your Google Drive. The platform requests only the minimum permissions needed:

* **Read files** — To download file contents for sync
* **Read metadata** — To detect changes and track file versions

### Step 4: Confirm Connection

After authorizing, you are redirected back to Equa. The connection status will show as "Connected" with your Google account name.

## Configuring Folder Sync

### Step 1: Add a Sync Mapping

Click **Add Folder Mapping** to create a new sync rule.

### Step 2: Select the Source Folder

Use the Google Drive folder browser to navigate and select the folder you want to sync from.

### Step 3: Set the Destination Path

Enter the Data Room path where synced files should appear (e.g., `/Google Drive/Financials`).

### Step 4: Configure Options

* **Sync subfolders** — Toggle on to include all subfolders within the source folder
* **File type filter** (optional) — Specify which file types to include or exclude by MIME type

### Step 5: Save the Configuration

Click **Save**. The mapping is saved and ready for sync.

## Common Tasks

### Running a Manual Sync

1. Navigate to the Google Drive sync page
2. Click **Sync Now**
3. Wait for the sync to complete

The system compares your Google Drive files with the last-synced versions using modification timestamps and file checksums. Only changed files are downloaded.

### Reviewing Sync History

Each sync run is recorded with:

* Sync timestamp
* Number of files synced
* Number of files added, updated, or skipped
* Any errors encountered

View the history on the Google Drive sync page.

### Editing a Sync Mapping

1. Find the mapping in the list
2. Click **Edit**
3. Update the source folder, destination path, or options
4. Click **Save**

### Removing a Sync Mapping

1. Find the mapping in the list
2. Click **Delete**
3. Confirm the action

Removing a mapping stops future syncs but does not delete files already synced to the Data Room.

### Disconnecting Google Drive

1. Navigate to **Settings > Integrations > Google Drive**
2. Click **Disconnect**
3. Confirm the action

This revokes Equa's access to your Google Drive. Existing synced files remain in the Data Room.

## How Sync Works

| Step                | What Happens                                                            |
| ------------------- | ----------------------------------------------------------------------- |
| Change detection    | Compares modification time and MD5 checksum against last sync           |
| Conflict resolution | Google Drive version wins — local copies are overwritten if they differ |
| New files           | Downloaded from Google Drive and created in the Data Room               |
| Updated files       | Re-downloaded and replace the existing version                          |
| Deleted files       | Not automatically removed from the Data Room (sync is additive)         |

## Tips

<Tip>
  Equa requests read-only access to your Google Drive. It cannot modify, delete, or create files in your Google Drive account.
</Tip>

<Tip>
  Set up sync mappings for your most important folders (e.g., legal documents, financial statements, board materials). This ensures your Data Room always has the latest versions.
</Tip>

<Tip>
  Access tokens are automatically refreshed when they expire. You should not need to re-authorize unless you revoke access from your Google account settings.
</Tip>

## Design References

Design-system source for this guide: [Google Drive screenshot gallery](/architecture/design-system/screenshots/google-drive) and [EquaFileUpload](/architecture/design-system/components/equa-file-upload), [EquaAlert](/architecture/design-system/components/equa-alert), [EquaProgress](/architecture/design-system/components/equa-progress), [EquaToast](/architecture/design-system/components/equa-toast).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Google Drive connection failed">
    **Cause:** The authorization flow may have been interrupted, or your browser may have blocked the redirect.

    **Solution:** Try again, making sure to complete the full authorization flow. Allow pop-ups for app.equa.cc in your browser settings.
  </Accordion>

  <Accordion title="Sync is not detecting new files">
    **Cause:** The sync compares modification timestamps. If files were added to a folder that is not included in your sync mapping, they will not be detected.

    **Solution:** Check that your sync mapping covers the correct Google Drive folder. If you enabled subfolder sync, make sure the new files are within the mapped folder hierarchy.
  </Accordion>

  <Accordion title="Some files were not synced">
    **Cause:** File type filters may be excluding certain file types, or there may have been errors during download.

    **Solution:** Check the sync history for error details. Review the file type filter settings on the sync mapping.
  </Accordion>

  <Accordion title="I need to re-authorize after a while">
    **Cause:** The refresh token may have been revoked from your Google account, or the token may have expired without successful refresh.

    **Solution:** Disconnect and reconnect Google Drive from the integration settings. This generates a fresh authorization.
  </Accordion>
</AccordionGroup>

## Related

* [Document Management](/guides/document-management)
* [Data Rooms](/guides/data-rooms)
* [Microsoft Integration](/guides/microsoft-integration)
* [Google Drive Integration Specification](/specs/016-google-drive-integration/spec)