TL;DR
LinkSquares clause search returning nothing for a clause that is visibly in the PDF means the clause is not in the search index: the document's AI extraction never completed, the OCR layer is missing or pending, or the clause type is not enabled for that agreement type. Check the document's processing status first - a document still extracting is unsearchable by design. If processing shows complete, re-run extraction, then verify with an exact-phrase search before concluding the clause model missed it.
The query
LinkSquares clause search returns no results for a clause that's in the PDF - how to fix
Use this when
- Clause search returns zero results but you can read the clause in the PDF
- Search worked for other documents but not this one
- A newly uploaded document is unsearchable
Not for
- Search returning wrong or irrelevant clauses - that is a ranking or query problem
- Full-text document search (not clause search) failing - different index, different fix
- All searches failing platform-wide - check for an incident before debugging one document
Steps
1. Check the document's processing status
Open the document in LinkSquares and look at its processing or extraction status. Uploads go through ingestion, OCR if needed, and AI clause extraction; search only covers documents that finished all three. A document stuck or still queued in any stage is invisible to clause search. Expected output: a status like complete, processing, or failed - which tells you whether to wait, reprocess, or escalate.
2. Re-run extraction if processing failed or stalled
Use the reprocess action on the document to rerun OCR and clause extraction from scratch. Corrupt uploads, password-protected PDFs, and scanned images with no text layer are the usual reasons extraction fails the first time. Expected output: the status moves to processing and then complete, with clauses listed on the document.
3. Search the exact clause phrase
Copy a distinctive phrase from the clause as it appears in the PDF and search it as an exact phrase. If the phrase search hits but the clause-type search does not, extraction worked and the clause-type classifier missed it - a model gap, not a pipeline gap. Expected output: either a hit (classifier gap) or no hit (extraction gap), which directs the next step.
4. Verify the clause type is enabled for the agreement type
Clause models are scoped: some clause types are only extracted for certain agreement types. Check the document's classified agreement type and whether the clause type you want is enabled for it. A misclassified agreement (e.g. an order form read as an NDA) hides whole clause categories. Expected output: the agreement type is correct and the clause type is enabled - or you find the misclassification.
Tool compatibility
LinkSquares Analyze (AI clause extraction and search). The ingestion-to-index pipeline is the same for all document sources.
Variant phrasings
- LinkSquares clause search no results clause in PDF
- LinkSquares search cannot find clause that exists in document
- LinkSquares document not indexed clause search empty
- LinkSquares reprocess document clause extraction failed
Why it happens
Clause search does not search the PDF - it searches the extracted, classified clause index built by the AI pipeline. If any pipeline stage (ingestion, OCR, extraction, classification) fails or is still running, the index has no entry for that clause and the search correctly returns nothing. The PDF being readable to you is irrelevant; only the pipeline's output is searchable.
Edge cases / pitfalls
- Scanned PDFs without OCR produce no searchable text at all - the document looks fine but the pipeline saw images.
- Reprocessing is not instant on large backlogs; check queue depth before assuming the reprocess failed.
- Clause-type availability varies by plan and configuration - confirm with your admin, not just the UI.
- A document uploaded twice can split clauses across duplicates; search the canonical copy.
Provenance
Resolved from the public thread: https://vectle.com/posts/pst_q98sL5mJK3yDB8HwyZv5NA