What is the GDOC file format?
A .gdoc file contains information pointing to a Google Docs document stored in the cloud. It stores the following:
- a URL and unique document ID linking to the online file,
- the Google account email address associated with the document.
.gdoc files are tiny JSON text files - they contain no text data, images or formatting, only a reference to a cloud-hosted document. Internally, each .gdoc file is a small JSON object with keys such as url, doc_id, email and resource_id that together identify the online document. .gdoc files are created by Google Drive for Desktop when it syncs your Google Drive to a local folder on Windows or macOS. Such files take almost no disk space and can be accessed by any registered Google user - double-clicking a .gdoc file launches the linked document in a browser. Uploaded files imported into Google Docs cannot be larger than 50 MB and documents cannot contain more than 1.02 million characters, regardless of page count or font formatting. Images embedded in Google Docs must be in JPEG, PNG, or GIF format, with the exception of animated images.
Google Docs offers its users a free, browser-based interface for creating documents and space for storing generated or imported documents. It offers similar design and functionality to standard office suite applications, but focuses on mobility and the benefits of cloud computing and real-time collaboration. Google's office suite includes:
- Google Docs - a word processor,
- Google Sheets - a spreadsheet,
- Google Slides - a presentation creator.
These services are also included in Google Workspace, an office suite for business environments that offers additional features. .gdoc documents can be exported into other popular formats and saved locally. They can also be shared with other users, with limited or full access. Documents saved in other formats can be imported into Google Docs.
Security & safety
RISK: LOWA .gdoc is a tiny JSON text file with no executable content - opening it is safe. The real considerations are privacy and access, not malware: the file only opens the cloud document if you are signed into a Google account that has permission, so sharing the .gdoc itself does not share the document (you must share it inside Google Drive). Treat the embedded URL like any link; do not assume a .gdoc gives offline access to anything.
Format details
in a nutshellPrograms that open GDOC files
Technical details
deep spec| File type | JSON text shortcut pointing to an online Google Docs document - not the document itself |
| MIME type | application/vnd.google-apps.document |
| Internal structure | UTF-8 JSON object containing keys: url, doc_id, email, resource_id |
| Typical file size | Under 1 KB - the actual document lives in the cloud |
| Binary signature | None - plain UTF-8 text; identified by JSON content rather than magic bytes |
| Created by | Google Drive for Desktop sync client (Windows and macOS) |
| How it opens | Double-clicking launches the linked document in the default web browser |
| Import file size limit | 50 MB maximum for files converted to Google Docs format on upload |
| Document character limit | 1.02 million characters per document, regardless of page count or formatting |
| Supported image formats | JPEG, PNG and GIF (non-animated) for images embedded in the linked document |
| Export formats | DOCX, ODT, RTF, PDF, TXT, HTML and EPUB from within Google Docs |
| Supported platforms | Windows and macOS via Drive for Desktop; Android and iOS via Google Docs / Drive apps |
| Related shortcut formats | .gsheet (Sheets), .gslides (Slides), .gdraw (Drawings), .gform (Forms) |
| Access requirement | A Google account is required to open the linked document at docs.google.com |
| Sharing model | Linked document can be shared as viewer, commenter or editor via Google Drive permissions |
| Released | 2017 (Google Drive desktop sync clients: Backup and Sync / Drive for desktop) |
| Specification | support.google.com |
GDOC conversions
Community Q&A
asked by usersNo questions yet - be the first to ask about GDOC files.