// troubleshooting guide · agent ransack
Agent Ransack Not Searching PDF Contents
- Status
- Workaround available
- platforms:
- Windows
- updated:
- November 18, 2026
- reports:
- 2
- Method
- how we research
RUNBOOK · agent-ransack/pdf-not-searching3 FIXES
// quick answer
Agent Ransack reads a PDF's text layer, so scanned image-only PDFs are skipped. OCR them first, then search again.
Most likely fix: OCR scanned PDFs
How to fix it
// try these in order, the most common fix is first
FIX 1OCR scanned PDFs
- 01Run the scans through an OCR tool to add a text layer
- 02Save and search again
Did this fix it?FIX 2Check the file mask and document settings
- 01Enter *.pdf in File name
- 02Open Document search settings and make sure the PDF reader is enabled
Did this fix it?FIX 3Confirm with a known text PDF
- 01Search a PDF you know contains text
- 02If it matches, the original was likely an image scan
Did this fix it?
SANDBOX · agent-ransack RUNS IN YOUR BROWSER
Try it: a launcher with snippets and clipboard history
A hands-on Agent Ransack-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.
Symptoms
Text-based PDFs match but scanned PDFs never appear, even with the right phrase.
Why it happens
- C-01Scanned PDF has no text layer
- C-02PDF reader or filter option disabled
- C-03File mask does not include *.pdf
// this guide also covers
- agent ransack search pdf
- agent ransack pdf not working
Still not working?
If Agent Ransack keeps failing, you're not alone. See every Agent Ransack problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to us