diff --git a/apps/docs/changelog/developer-platform.mdx b/apps/docs/changelog/developer-platform.mdx
index 4f76925f..eef2ce83 100644
--- a/apps/docs/changelog/developer-platform.mdx
+++ b/apps/docs/changelog/developer-platform.mdx
@@ -6,6 +6,10 @@ description: "API updates, new endpoints, and SDK releases"
 
 API updates, new endpoints, SDK releases, and developer-focused features.
 
+## April 13, 2026
+
+- **Google Drive scoped sync:** New connections default to a **hosted folder/file picker** after OAuth; only chosen items sync. Use `metadata.syncScope: "full"` to sync the whole Drive. Import jobs **skip** scoped connections until a selection exists.
+
 ## March 18, 2026
 
 - **Supermemory CLI:** New command-line tool for managing memories, documents, profiles, tags, connectors, and API keys directly from the terminal.
diff --git a/apps/docs/changelog/overview.mdx b/apps/docs/changelog/overview.mdx
index b27195c6..86dc0bc1 100644
--- a/apps/docs/changelog/overview.mdx
+++ b/apps/docs/changelog/overview.mdx
@@ -3,6 +3,14 @@ title: "Changelog"
 description: "New updates and improvements to Supermemory"
 ---
 
+<Update label="April 13, 2026" tags={["Integrations", "API"]}>
+
+### Google Drive: scoped sync by default
+
+New Google Drive connections default to **folder and file** scope: after OAuth, users complete a hosted picker; only selected items sync. Set `metadata.syncScope` to `"full"` on connection creation to sync the entire Drive without the picker. Scoped connections without a saved selection are skipped by import jobs until setup is finished.
+
+</Update>
+
 <Update label="March 18, 2026" tags={["API", "SDK", "Console", "CLI"]}>
 
 ### Supermemory CLI
diff --git a/apps/docs/connectors/google-drive.mdx b/apps/docs/connectors/google-drive.mdx
index 94bc7809..9c3ac2a5 100644
--- a/apps/docs/connectors/google-drive.mdx
+++ b/apps/docs/connectors/google-drive.mdx
@@ -6,6 +6,18 @@ icon: "google-drive"
 
 Connect Google Drive to sync documents into your Supermemory knowledge base with OAuth authentication and custom app support.
 
+## Sync scope
+
+**Default for new connections:** after OAuth, the user completes a **folder and file** picker (Google Docs, Sheets, Slides, and PDFs). Only items they select are synced and updated until they change the selection (for example from the Supermemory console).
+
+**Whole Drive:** set `metadata.syncScope` to `"full"` when creating the connection so the entire Drive syncs without the picker.
+
+**Explicit scoped mode:** set `metadata.syncScope` to `"selected"` for the picker flow, or rely on the default for new connects.
+
+<Note>
+If you use scoped sync and the user has not finished the picker yet, **scheduled or manual import may skip that connection** until a selection is saved on the connection.
+</Note>
+
 ## Quick Setup
 
 ### 1. Create Google Drive Connection
@@ -25,7 +37,8 @@ Connect Google Drive to sync documents into your Supermemory knowledge base with
       documentLimit: 3000,
       metadata: {
         source: 'google-drive',
-        department: 'engineering'
+        department: 'engineering',
+        syncScope: 'selected'
       }
     });
 
@@ -48,7 +61,8 @@ Connect Google Drive to sync documents into your Supermemory knowledge base with
         document_limit=3000,
         metadata={
             'source': 'google-drive',
-            'department': 'engineering'
+            'department': 'engineering',
+            'syncScope': 'selected',
         }
     )
 
@@ -68,16 +82,21 @@ Connect Google Drive to sync documents into your Supermemory knowledge base with
         "documentLimit": 3000,
         "metadata": {
           "source": "google-drive",
-          "department": "engineering"
+          "department": "engineering",
+          "syncScope": "selected"
         }
       }'
     ```
   </Tab>
 </Tabs>
 
+<Note>
+For **whole Drive** sync, include `"syncScope": "full"` in `metadata` on the same `POST /v3/connections/google-drive` request instead of `"selected"`.
+</Note>
+
 ### 2. Handle OAuth Callback
 
-After user grants permissions, Google redirects to your callback URL. The connection is automatically established.
+After the user grants permissions, Google redirects through Supermemory to finish the connection. With **scoped** sync (`syncScope` omitted or `"selected"`), the user is sent to Supermemory’s **hosted file and folder picker**; they must complete that step before imports run. With **`syncScope: "full"`**, Supermemory redirects to your `redirectUrl` (or returns connection details) **without** the picker. You can open the picker again later for an existing connection (Supermemory console, or `POST /v3/connections/{connectionId}/google-drive/hosted-picker` with an authenticated admin session).
 
 ### 3. Check Connection Status