You pay for a 2TB, 5TB, or 10TB Google One or Google Workspace subscription. Your storage dashboard shows you have used only 400GB. Yet, when you attempt to create a new folder or upload a project, you are hit with an unexplainable error: "Upload failed: An error occurred while creating files." Welcome to Google Drive's most controversial secret: the 2 million item limit.
Google Drive enforces a strict account-level cap of 2,000,000 total items (including files, folders, shortcuts, and items in Trash) per individual Google account, regardless of how many gigabytes of purchased storage remain available. This is essentially a cloud-level inode limit designed to preserve database performance on Google's metadata tables.
How Users Accidentally Hit the Limit (Even with Low Gigabyte Usage)
Most users assume that 2 million files is an impossibly huge number. However, certain common modern developer and creative workflows can exhaust 2 million files in mere weeks:
- Node.js Projects (
node_modules): A single modern web development project can contain 40,000 to 100,000 tiny JavaScript dependency files. Syncing 20 projects can easily generate 1.5 million files. - Python Virtual Environments (
.venv): Automated data science libraries and site-packages generate hundreds of thousands of loose files. - Unemptied Trash / Bin: Files in your Google Drive Trash still count toward your 2 million item quota until permanently purged.
- Automated Backup Scripts: Scripts generating timestamped JSON telemetry or logs every minute will burn 500,000 items in a single year.
How to Audit and Check Your File Count
Google does not display your total item count on the standard storage page. To check how close you are to the limit:
- Google Takeout Inspection: Visit Google Takeout, select only Drive, and view the estimated archive manifest.
- Drive API Query via Script: Run a lightweight Python script using the Google Drive API to calculate your total item tally:
# Quick tally of files and folders query = "trashed = false" results = service.files().list(q=query, pageSize=1000, fields="nextPageToken, files(id)").execute()
3 Actionable Fixes to Recover Your Account
- Archive Dependencies into ZIP Containers: Never sync uncompressed
node_modulesor build folders. Compress them into a single.tar.gzor.zipbefore uploading. That replaces 80,000 items with exactly 1 item. - Permanently Empty Your Trash: In Google Drive web, click Trash in the left sidebar and select "Empty trash". This instantly removes deleted items from your metadata quota.
- Migrate to Google Workspace Shared Drives: Unlike individual "My Drive" storage (which caps personal files at 2 million), Google Workspace Shared Drives have a separate limit of 400,000 items per shared drive, and you can create hundreds of separate Shared Drives under one organizational domain.