# Google Drive

Image files, or other file resources, located in your Google Drive account can be uploaded into your Overleaf projects using the [From External URL feature](/managing-projects-and-files/adding-files-to-a-project/adding-a-file-from-a-url.md#overleafs-from-external-url-feature)—provided those Google Drive files have file-sharing enabled. In addition, you will need to create a suitable URL ([direct download link](/managing-projects-and-files/adding-files-to-a-project/adding-a-file-from-a-url.md#direct-download-links-urls)) which can be used to add each Google Drive file to your Overleaf projects. This article explains how to do that.

Once uploaded from Google Drive, the corresponding Overleaf project file(s) can be refreshed at any time to resync them with the latest version stored in Google Drive—[the video below](#video-showing-google-drive-file-upload) demonstrates how to do that.

## Notes and caveats on changes to Google-based services

File-hosting services such as Google Drive can, at any time, make changes to their services; in particular, modifying the structure of link-sharing URLs. For example, in 2021 Google announced a [Google Drive security update](https://support.google.com/a/answer/10685032?hl=en) which added the **`resourcekey`** parameter to their file-sharing URLs. However, due to the nature of this update, it seems that not all users (or all their files) will be immediately affected by this change. Some Google Drive users will see the **`resourcekey`** parameter, others might not.

Due to such unpredictable changes, it’s impractical for Overleaf to provide consistently up-to-date and fully documented URL-conversion processes for Google Drive or similar services. Such guidance could quickly become out-of-date and thus misleading. However, in this page we provide one way to convert Google Drive file-sharing URLs containing the **`resourcekey`** parameter to a direct download URL you can use with Overleaf. Our team has tested this procedure and it worked for us but we cannot guarantee it will be relevant to, or work for, everyone. In case of difficulty, readers should, in the first instance, try to find and consult the most current documentation provided by the hosting service(s) they use, or seek out up-to-date articles or YouTube videos.

## Sharing a file in Google Drive

Start by identifying a file stored in Google Drive that you want to upload into your Overleaf project:

![Uploading a Google Drive file to Overleaf](/files/7QPFYyVgGgp8auZzWeUe)

Next, you need to *share* that file, to make it accessible outside of Google Drive. The following screenshot, taken on a desktop PC, shows how to access the file-sharing and file-link options within Google Drive:

![Uploading a Google Drive file to Overleaf](/files/00Yk1KcotnxW0gZ6k4tJ)

After you select the option to share the file, a **Share with people and groups** dialog box appears (see below). From here you can choose to share that file with particular individuals/groups or make it available to anyone who has the appropriate Google Drive link.

Here, we’ll share the file with anyone who has the Google Drive link by changing the link-sharing setting from Restricted to **Anyone with the link**, as shown in the following screenshot taken from a desktop device (Windows laptop):

![Uploading a Google Drive file to Overleaf](/files/FV7FhRCbHB4jLJe6t8pI)

## Obtain a Google Drive link to your shared file

After selecting the preferred link-sharing option, we need to obtain a copy of the Google Drive link (URL) to our shared file. There are several ways to do this:

* choose **Copy link** from the dialog box above (if still visible on your screen), or
* right-click on the file and choose **Get link** (see screenshot below) then select **Copy link** from the pop-up box, or
* select the link option displayed to the right (see screenshot below) then select **Copy link** from the pop-up box.

![Uploading a Google Drive file to Overleaf](/files/PxrHo52bAT9Cbj3Pj3rc)

## Creating a direct download URL for Overleaf

After copying the Google Drive link (URL), paste it into a text editor of your choice—because we will use it to derive a *direct download URL* for use with Overleaf: a URL that Overleaf can use to download the Google Drive file and add it to your project.

After pasting the Google Drive link (URL) into a text editor, you should see it has the following structure:

```
https://drive.google.com/file/d/FILE_ID/view?usp=sharing&resourcekey=RESOURCE_KEY
```

To construct a download URL, we need the following components of the Google Drive link:

* `FILE_ID`
* `resourcekey=RESOURCE_KEY`

Here is an image highlighting the `FILE_ID` and `RESOURCE_KEY` components:

![Structure of a Google Drive link URL](/files/YZHUnaWAVpumP04ZjscU)

`FILE_ID` and `RESOURCE_KEY` are lengthy alphanumeric character sequences so be careful when you copy them to avoid missing/dropping any characters.

Having extracted the `FILE_ID` and `RESOURCE_KEY`, use the following template to construct the download URL for Overleaf:

```
https://drive.google.com/uc?export=download&id=FILE_ID&resourcekey=RESOURCE_KEY
```

Here is an image highlighting use of the `FILE_ID` and `RESOURCE_KEY` components within the constructed download URL:

![Structure of a Google Drive download URL](/files/g5V6x5DGvqv7OyXf0QyI)

You are now ready to upload the Google Drive file to your Overleaf project.

## Uploading the Google Drive file into an Overleaf project

To use the download URL, select Overleaf’s file upload feature and choose **From External URL**:

![Uploading a Google Drive file to Overleaf](/files/bARpYJcu1sBdPRsxkWgO)

Paste in the download URL, give the file a name and select **Create** to add (upload) your Google Drive file to an Overleaf project.

### Video showing Google Drive file upload

The following video demonstrates use of a download URL to add a Google Drive file into an Overleaf project.

{% embed url="<https://videos.ctfassets.net/nrgyaltdicpt/2PMXTshGJI0Kg2ZtN6iXtk/18d4a3168847009a39f905c9acc45e51/Google_drive_upload.mp4>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.overleaf.com/integrations-and-add-ons/google-drive.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
