# Connect Google Drive

Sign in to Google Drive from the Add Knowledge Source wizard, limit the source to a folder if you want, and start its first sync.

The Google Drive connector indexes files from a Google Drive you sign in to, so agents can answer from them. This page covers what is specific to Google Drive; the steps every connector shares are in [Add a knowledge source](/knowledge/knowledge-bases/add-a-knowledge-source).

**Who can use it:** the **Builder** role, or a Member holding the **Knowledge Admin** grant, in a tenant licensed for knowledge. One-click sign-in also needs an administrator to have stored a Google OAuth app on the **Credentials** tab of Knowledge Management.

## What it brings in

In the wizard, Google Drive sits in the **Recommended** row and under the **Cloud Storage** chip, described as **Workspace files**. The Catalog's **Connectors** section lists it with the same description and says how it signs in. The connector can read only what the Google account you sign in with can open. Who may use the source inside Katonic is a separate choice, made on the **Schedule & Access** step.

## Prerequisites

- An embedding model configured on the **Settings** tab of Knowledge Management. Until then **Connect Source** is disabled.
- A Google account that can open the drives or folders you want indexed.
- Either a Google OAuth app stored by your administrator, which gives one-click sign-in (see [Set up connector credentials](/knowledge/knowledge-bases/credentials)), or your own OAuth app's Client ID and Client Secret.
- Pop-ups allowed for the Katonic site: the sign-in opens in a pop-up window.

## Connect the source

  
**Step 1. Pick Google Drive**

In the Control Room, open **Knowledge** and select **Connect Source**. On **Select Source**, choose **Google Drive** in the **Recommended** row, or filter by **Cloud Storage** and select its card; the wizard moves to **Configure**. From the Catalog's **Connectors** section, **Connect** on the Google Drive card opens **Connect Source** with Google Drive already chosen.

  
**Step 2. Name the source and pick its resources**

Enter a **Knowledge Name**. Under **Resources**, keep the preselected option or pick another: each one says what kind of documents it is meant for.

  
**Step 3. Sign in to Google Drive**

![Step 2 of the Add Knowledge Source wizard, Configure, for Google Drive: the Resources options, then the Connect to Google Drive box saying credentials are pre-configured by your admin, its Connect with Google Drive button and the note that it opens a secure popup, above the Back, Cancel and Next buttons.](https://docs.katonic.ai/img/knowledge/connectors/google-drive/connector-google-drive-configure.png)
*Configure for Google Drive when your administrator has stored the OAuth app: no Client ID or Client Secret is asked for, and Connect with Google Drive opens the sign-in pop-up. Next stays disabled until the connection succeeds.*
    The **Connect to Google Drive** box has two variants. When your administrator has stored a Google OAuth app, it reads **Click below to sign in with Google Drive - credentials are pre-configured by your admin** and offers **Connect with Google Drive** at once. When no app is stored, the step first asks for a **Client ID** and a **Client Secret**, and the box reads **Sign in with Google Drive to securely connect your account**. Either way, **Connect with Google Drive** opens a secure pop-up where you sign in to Google and grant access; the button reads **Connecting…** while the wizard waits. On success the box changes to **Connected to Google Drive** with **OAuth authorization successful**, a toast confirms it, and a **Disconnect** button lets you start again. **Next** stays disabled until the source is named and connected.

  
**Step 4. Limit the source to a folder**

After the connection, **Folder URL or ID (optional)** appears. Paste the folder's link or its ID to index only that folder, or leave the field empty to index everything the account can open. A connector may also add settings of its own to this step.

  
**Step 5. Schedule, access and review**

Select **Next**. **Schedule & Access** is the same for every connector: **Sync Schedule**, **Knowledge plane** and **Access**. Google Drive has no permission sync; the **Access** choice decides who inside Katonic can open the source and does not change what the connector reads. Select **Review**. The summary lists **Source**, **Name**, **Authentication** as **OAuth (connected)**, **Schedule**, **Graph Extraction**, **Access** and **ACL Sync** as **None (open access)**. Select **Connect Source**: it reads **Creating...** while the source is created, and the first sync starts straight away.

## Verify

The new row appears on the **Sources** tab as **Syncing**, then **Synced** with a document count when the first sync finishes. Open the source: its **Documents** tab lists the indexed files and its **Runs** tab shows the sync. See [Browse and curate a source's documents](/knowledge/knowledge-bases/documents).

## Troubleshooting

- **Client ID and Client Secret are required.** You selected **Connect with Google Drive** without filling both fields. Fill them, or ask your administrator to store the app on the **Credentials** tab so the fields disappear.
- **Popup blocked. Please allow popups for this site.** Allow pop-ups for the Katonic site in your browser, then select **Connect with Google Drive** again.
- **OAuth didn't complete - the popup may have been closed. Try again.** The wizard waits about two minutes for the sign-in to finish. Keep the pop-up open until it closes by itself, then retry.
- **OAuth connection failed. Please try again.**, or a reason from the provider: the sign-in could not start, or Google rejected it. Check the Client ID and Client Secret, or ask your administrator to run **Test** on the stored credential.
- **Next stays disabled.** The source needs a **Knowledge Name** and a completed connection.
- **Source created, but the first sync couldn't start - open it and click Reindex.** The source exists but nothing is indexed yet. Open it and select **Reindex**.
- **Fewer files than expected.** The connector reads only what the connected account can open. Check that account's access in Google Drive and the folder you entered, then reindex.

## Related

- [Connectors](/knowledge/connectors/overview)
- [Set up connector credentials](/knowledge/knowledge-bases/credentials)
- [Add a knowledge source](/knowledge/knowledge-bases/add-a-knowledge-source)
- [Browse and curate a source's documents](/knowledge/knowledge-bases/documents)

Source: https://docs.katonic.ai/knowledge/connectors/google-drive
