GDOC File Documentation

Summary

A Google Drive Document file is not a document at all — it is a tiny shortcut, a few hundred bytes of JSON, that points to a document stored online in Google Docs. The actual text lives in Google’s cloud, not in the file. Double-clicking a .gdoc opens that document in your browser, and only if you are signed in to a Google account with access. Its MIME type is application/vnd.google-apps.document. You cannot open it offline or convert the .gdoc itself.

Technical details

FeatureValue
Full nameGoogle Docs shortcut (link to an online Google Docs document)
File extension.gdoc
MIME typeapplication/vnd.google-apps.document
Format typeTiny UTF-8 JSON pointer — not the document itself
CategoryText / cloud shortcut
DeveloperGoogle
Introduced2017 (Drive desktop sync: Backup and Sync / Drive for desktop)
Created byGoogle Drive for desktop, when a Docs file appears in a synced folder
Typical sizeA few hundred bytes
ContentsJSON with keys such as url, doc_id, resource_id, email
Holds the text?No — the document lives online in Google’s cloud
Works offline?No — needs internet and the right Google account
Magic numberNone — plain JSON text, detect by content
Open withA web browser (opens the live doc in Google Docs)
Export real files viaGoogle Docs → File → Download (DOCX, PDF, ODT, RTF, TXT, HTML)
Sibling formats.gsheet, .gslides, .gdraw, .gform
Related extensions.docx, .pdf, .odt

What is a GDOC file?

A .gdoc file is a pointer, not a document. It is a small placeholder written by Google Drive’s desktop sync client (Drive for desktop, formerly Backup and Sync, which added this behaviour around 2017). When a Google Docs document appears in a folder that Drive syncs to your computer, Drive cannot download the document the way it downloads a JPEG or a Word file, because a Google Docs document is a native cloud object with no ordinary local representation. Instead it writes a tiny stand-in: a .gdoc file containing a JSON link to the online document. The registered MIME type, application/vnd.google-apps.document, describes the cloud document, not the local stub.

The consequence surprises many people. The .gdoc holds no text, no images and no formatting. Open it in Notepad or any editor and you see only a short JSON object, something like:

{
  "url": "https://docs.google.com/document/d/<doc_id>/edit?usp=drivesdk",
  "doc_id": "<doc_id>",
  "email": "you@example.com",
  "resource_id": "document:<doc_id>"
}

That is the entire file. There is nothing else inside it.

The JSON fields and what they do

The stub is UTF-8 text and each key has a single job. The url is the docs.google.com address that a browser opens. The doc_id (mirrored in resource_id) is the document’s unique Google Drive identifier, the same long string you see in the document’s web address. The email records which Google account the synced file belongs to, so the right account is used when you open it. Double-clicking the .gdoc hands the url to your default browser, which loads the live document — provided you are signed in to an account that has permission to view it.

Why the file “won’t open” offline or on another computer

Because the document lives in Google’s cloud and the .gdoc only names it, the stub is useless without two things: an internet connection and the correct Google account. This explains the most common complaints about the format. Copy a .gdoc to a USB stick and it opens nothing on a machine that is offline. Email it to a colleague and they see only the JSON link, or an access error, unless the document itself has already been shared with them inside Google Drive. Sharing the file does not share the document; the two are separate. It is exactly the “it’s a shortcut, not the thing’s content” situation you get with a web .url shortcut or an ACSM download token.

Getting a real, portable file (DOCX, PDF and others)

There is nothing inside the .gdoc to convert, so offline “gdoc to docx” or “gdoc to pdf” converters cannot work — they would be converting a link. The real export happens in the cloud document. Open the document through the .gdoc link (or straight from Google Drive), then use File → Download and pick the format you want: Microsoft Word (.docx), PDF, OpenDocument (.odt), Rich Text (.rtf), plain text (.txt) or a zipped web page (.html). That exported file contains the actual text and is the thing to keep offline or send to someone else. If you need offline access later, download a DOCX or PDF copy in advance.

The sibling shortcuts: gsheet, gslides, gdraw, gform

Google Drive writes the same kind of pointer for its other cloud apps. A .gsheet points to a Google Sheets spreadsheet, .gslides to a Slides presentation, .gdraw to a Drawing and .gform to a Form. None of them contain the actual content; every one is a small JSON stub that opens the live file online. Everything in this page about .gdoc applies to them unchanged.

Frequently asked questions

Because a .gdoc is a shortcut, not the document. The text lives online in Google Docs; the file only stores a JSON link to it. Opening it in a browser while signed in shows the real document.

How do I convert a GDOC to Word (DOCX) or PDF?

Open the document via the .gdoc link in Google Docs, then use File → Download and choose Microsoft Word (.docx) or PDF. You cannot convert the .gdoc itself, because it contains no document content.

Can I open a GDOC file without internet?

No. The document is stored in Google’s cloud and the .gdoc only points to it, so with no connection there is nothing to open. Download a DOCX or PDF copy beforehand for offline use.

I emailed a GDOC and the recipient can’t open it — why?

You sent only the shortcut, not the document. Share the document inside Google Drive (Share, then add their email or get a link), or download it as DOCX or PDF and send that file instead.

References