Search or filters not returning results Free & Pro

When FileDeck search or filters come up empty, the cause is almost always one of five things: you are searching for text the search does not cover, the content-search index is out of date, the document is hidden from this visitor or this library, a page cache is serving stale results, or an optimization plugin is blocking FileDeck’s JavaScript. Work through the sections below in order.

What search actually matches

FileDeck’s keyword search matches a document’s title, excerpt, description, categories, tags, and filename. With content search, it also searches inside the files themselves — PDFs, Office documents, and text files — once the search index is built. See search, sort, and filter for the full behavior.

If a phrase that appears only inside a file returns nothing, the index is the first thing to check.

Searches inside file contents return nothing

Content search relies on an index of your files’ text. If searches for phrases inside files come back empty:

1. Go to Documents → Settings → Search Index and click Rebuild search index. Rebuilding is needed after a bulk import, or whenever results look out of date.
2. If the missing documents are scanned or photographed PDFs, they have no text layer to index. Enable OCR under Documents → Settings → Scanned OCR, then run OCR from Documents → Settings → Search Index — see scanned-PDF OCR.

The Search Index tab shows how many documents are indexed, which is a quick way to spot an empty index.

A document does not appear in results

If a specific document is missing from the library or from search results, check these in order:

1. Is it published? Go to Documents → All Documents and confirm the document’s status is Published, not Draft, Pending, or Scheduled.
2. Has it expired? (Pro) If the document has an auto-expiry date in the past, it is no longer available in the library.
3. Is it restricted for this visitor? (Pro) Access control can hide documents from visitors who do not meet a password, role, or user restriction — at the document, category, or library level. Test in a private browsing window and while logged in as an appropriate user to compare.
4. Is it outside the library’s category scope? If the block or shortcode uses category scoping (for example [filedeck category="policies"]), only documents in that category appear. Check the document’s categories against the scope set on the block or in the shortcode.

A quick diagnostic: if the document appears when you view the library as an administrator but not as a logged-out visitor, the cause is access control or expiry, not search.

Filter dropdowns are empty

The category and tag filter dropdowns only show terms that are actually in use within the current library. Two common causes for an empty dropdown:

• No categories or tags assigned. If your documents have no categories (or no tags), there is nothing to filter by. Assign terms under Documents → Document Categories and Documents → Document Tags.
• Scoped out. If the block or shortcode is scoped to one category, terms outside that scope do not appear in the filters.

Results are stale after edits

If you added, renamed, or recategorized documents but the library still shows the old state, a page cache is serving an outdated copy of the page. For libraries of 500 documents or fewer, the search index is inlined into the page itself, so a cached page also means a cached index.

Fix: Purge your page cache (and CDN, if any) after making changes, or set a reasonable cache lifetime so edits appear automatically. The library’s own data rebuilds automatically when the page is regenerated — only the content-search index is separate, with its own rebuild button under Documents → Settings → Search Index.

The search box does nothing at all

If typing in the search box has no effect, or the filter dropdowns and sortable column headers are inert, FileDeck’s JavaScript is not loading or is loading too late. The usual culprit is an aggressive script optimization plugin that defers, delays, combines, or minifies scripts.

Fix:

1. Temporarily disable script optimization (defer/delay/combine settings) and reload the library page. If search works, you have confirmed the cause.
2. Re-enable optimization but exclude FileDeck’s assets from it. Most optimization plugins accept an exclusion keyword — add filedeck so its scripts and styles are left untouched.
3. Clear all caches and retest in a private browsing window.

Because FileDeck output is server-rendered with progressive enhancement, the document list itself still displays even when scripts are blocked — only the interactive parts (instant search, filters, click-to-sort) stop working, which makes this failure easy to recognize.

FAQ

Can visitors search the text inside PDFs or other files?

Yes, with content search: FileDeck searches inside PDFs, Office documents, and text files once the index is built. Keyword search alone covers title, excerpt, description, categories, tags, and filename.

Why can I see a document that my visitors cannot?

It is usually Pro access control or an expiry date. Administrators often pass restrictions that logged-out visitors fail, so always test in a private browsing window.

Do I need to rebuild a search index after importing documents?

For content search, yes — go to Documents → Settings → Search Index and click Rebuild search index after a bulk import. Also purge your page cache so visitors get the updated page.