AI AI Tools Guidebook
Troubleshooting

Gemini File Upload Fails or Returns Wrong Content

File attached but Gemini "doesn't see" it, or summary is wildly off? Size, type, and Drive permission.

Published: Author: AI Productivity Guide Team 🌐 查看中文版本

Upload a PDF to Gemini and one of three things goes wrong: the upload spins forever, the upload succeeds but Gemini says it can’t see the file, or it reads the file but the summary is completely wrong. Each failure mode has a different root cause: size cap, format unsupported, Drive permission gap, or scanned PDF with no text layer. Gemini’s pipeline is “format whitelist + content pre-processing”; failure at either stage looks like “successful” upload but is functionally broken.

To make sure Gemini actually reads your file, check in order: format → size → content quality.

Common causes

By frequency:

1. File exceeds size cap (most common)

Per-file caps by tier:

TierPer-fileTotal attachments
Free Web100 MB10 files
AI Premium Web2 GB10 files
API2 GBdepends on context window
WorkspaceIT-setIT-set

How to judge: upload bar at 100% but no “attached” label, or “file too large” error.

2. Unsupported format

Supported:

  • ✅ PDF, DOCX, TXT, MD, RTF
  • ✅ XLSX, CSV
  • ✅ PNG, JPEG, WEBP, HEIC
  • ✅ MP4, MOV, AVI (video)
  • ✅ MP3, WAV, M4A (audio)
  • ✅ Common code files (py, js, ts, go, rs, java, etc.)

Not supported:

  • ❌ ZIP / RAR / 7z archives
  • ❌ DMG / EXE
  • ❌ Old DOC (Word 95-2003 — convert to DOCX first)
  • ❌ KEY / PAGES / NUMBERS (Apple native)
  • ❌ EPUB (in some cases)

How to judge: upload button rejects / shows “unsupported format”.

3. Drive file but Gemini lacks Drive scope

Using “Add from Drive” needs Drive OAuth scope. If the OAuth flow was interrupted or the Drive scope was denied — file inaccessible.

How to judge:

  • Drive file list shows the file but clicking gives “unable to access”
  • Yellow bar on gemini.google.com: “Grant Drive access”

4. Scanned PDF (no text layer)

A PDF that looks like a document but is really scanned images:

  • Short doc (< 10 pages): OCR runs
  • Long doc (> 30 pages): OCR breaks down, summary becomes nonsense

How to judge: in Adobe Reader, can you select and copy text from the PDF? No = scanned.

5. Password-protected PDF

Encrypted PDFs can’t be parsed by Gemini, even if they open fine on your machine.

How to judge: original requires a password to open.

6. Special characters in filename

Filenames with emoji / control characters / extreme unicode can fail.

How to judge: rename to simple ASCII; if it now works → this.

7. Workspace IT set stricter limits

Work account upload caps may be lower than the public tier.

Shortest path to fix

Step 1: Check size + format

# Size
ls -lh your_file.pdf
# > 100 MB fails on free tier

# Format
file your_file.pdf
# Should return "PDF document"

Convert unsupported formats:

  • Apple Pages / Numbers → File → Export to PDF
  • Word .doc → Save As .docx
  • ZIP → extract and upload individual files
  • EPUB → convert with Calibre to PDF

Step 2: Compress under the cap

# Compress PDF (GhostScript)
gs -sDEVICE=pdfwrite -dCompatibilityLevel=1.4 -dPDFSETTINGS=/ebook \
   -dNOPAUSE -dQUIET -dBATCH -sOutputFile=compressed.pdf input.pdf

# Image-heavy PDFs
convert input.pdf -compress jpeg -quality 50 compressed.pdf

PDFs typically compress to 30-50% of original. Still > 100 MB? Split into batches.

Step 3: OCR scanned PDFs

# ocrmypdf (open source, most reliable)
brew install ocrmypdf
ocrmypdf scanned.pdf searchable.pdf

# Or online: adobe.com/acrobat/online/ocr-pdf.html

Post-OCR, Gemini reads actual text — summary quality jumps dramatically.

Step 4: Decrypt PDF

# With known password
qpdf --password=YOUR_PASS --decrypt input.pdf output.pdf

# Or Adobe Acrobat → File → Properties → Security → No Security

Step 5: Re-authorize Drive scope

1. gemini.google.com yellow bar "Grant Drive access" → click
2. Or myaccount.google.com → Security → Third-party access → find Gemini → re-authorize
3. In OAuth popup, **check all permissions** — don't skip Drive scope

Step 6: Simplify filename

mv "My Report 📊 v3 - Final!!.pdf" "report_final.pdf"

ASCII + underscores; no spaces, no special characters.

Step 7: Use API / AI Studio (most reliable)

If Web UI keeps failing:

aistudio.google.com
New prompt → upload file
Wider limits than gemini.google.com (2 GB per file)

Step 8: Workspace — talk to IT

Work account limited:

  1. IT → Admin Console → Gemini app for Workspace
  2. Raise “Maximum file size”
  3. Enable required file types

Prevention

  • Keep critical docs in PDF / DOCX / TXT; avoid Pages / EPUB / proprietary formats
  • OCR all scanned PDFs with ocrmypdf before uploading
  • Filenames: ASCII + underscores only; no spaces, no emoji
  • Confirm Gemini has Drive scope before uploading Drive files
  • For long-context / large files, use aistudio.google.com — caps are 20× wider

Tags: #Gemini #Debug #Troubleshooting

Related Articles