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

# Google Drive Integration

> Two-way file sync between Nextoria Hub and your Google Drive.

## Overview

The Google Drive integration lets your team work with Drive files directly inside Nextoria Hub's file manager — without downloading and re-uploading. Changes sync bidirectionally within 60 seconds.

## Prerequisites

* A Google Workspace or personal Google account
* Admin access on your Nextoria Hub workspace
* Growth or Scale plan

## Setup

<Steps>
  <Step title="Connect Google Drive">
    Go to **Settings → Integrations → Google Drive** and click **Connect with
    Google**. You'll be redirected to Google's OAuth consent screen.
  </Step>

  <Step title="Authorize permissions">
    Nextoria Hub requests the following scopes: - `drive.file` — access files
    created or opened by Nextoria Hub - `drive.readonly` — read files you choose
    to sync - `drive.metadata.readonly` — read file names and folder structure

    <Warning>
      Nextoria Hub does **not** request access to your entire Drive. It can only
      access folders you explicitly add through the sync configuration.
    </Warning>
  </Step>

  <Step title="Select folders to sync">
    After authorization, click **Add Sync Folder**. Browse your Drive hierarchy
    and select one or more folders to mirror in Nextoria Hub.
  </Step>

  <Step title="Configure sync settings">
    For each synced folder: - **Sync Direction**: Two-way, Drive → Nextoria Hub
    only, or Nextoria Hub → Drive only - **Team Access**: Which roles can see
    the synced files in Nextoria Hub - **Client Visible**: Optionally expose
    synced files in the client portal
  </Step>
</Steps>

## How Sync Works

* **Drive → Nextoria Hub**: Changes in Drive (new files, edits, moves, deletions) appear in the corresponding Nextoria Hub folder within 60 seconds via Google Drive push notifications.
* **Nextoria Hub → Drive**: Files uploaded or moved in Nextoria Hub are written back to the corresponding Drive folder via the Drive API.

Deleted files are moved to Trash in both systems — not permanently deleted — giving a 30-day recovery window.

## Folder Mapping

Synced folders appear in the Nextoria Hub file manager with a Google Drive icon. The folder path in Nextoria Hub mirrors the path in Drive:

```
Google Drive (synced)
└── Acme Corp → Nextoria Hub: Files / Clients / Acme Corp (Drive)
    ├── Briefs
    ├── Assets
    └── Deliverables
```

## Supported File Types

Google Workspace native files (Docs, Sheets, Slides) are linked — clicking them opens the file in Google's editor in a new tab. All other file types (PDFs, images, videos, etc.) are mirrored as full copies in Nextoria Hub storage.

## Disconnecting

To disconnect Google Drive, go to **Settings → Integrations → Google Drive → Disconnect**. Synced folders remain in Nextoria Hub as static copies — no files are deleted.

To revoke Nextoria Hub's access entirely, visit [Google Account Security → Third-party apps](https://myaccount.google.com/permissions) and remove Nextoria Hub.