Troubleshooting Flipset
Fixes for a blank viewer, PDFs from other domains, slow large files and missing search results.
On this page
The viewer is blank
This usually follows turning on a cache or optimisation plugin. Flipset already excludes its scripts in WP Rocket, W3 Total Cache, Autoptimize, LiteSpeed Cache and SiteGround Optimizer. If you use another one, add flipset-viewer.js, pdf.min.js and pdf.worker.min.js to its exclude list for minify, combine and delay.
A PDF works on my site but fails from another domain
The file host must allow your page to fetch it. A PDF on another domain needs CORS headers (Access-Control-Allow-Origin). Files in your own Media Library work without extra setup. When access is blocked, Flipset shows a message with a direct link to the file.
A large PDF feels slow
Flipset draws only the visible page, or the visible two-page spread, and in scroll mode only the pages nearby. A big file still has to be downloaded once. Compress or split very large files.
Site search does not find words from my PDF
- Open Flipset → Docs & Features once so the text is extracted.
- Scanned image-only PDFs have no text. Run OCR on them first.
- Password-protected PDFs are skipped.
- Check that Search and sharing is turned on in Flipset → Settings.
A PDF shows “Untagged”
See Accessibility and the Untagged check.
The embed shows “no file URL” or “Embed ID not found”
The shortcode needs a file ([flipset file="https://example.com/document.pdf"]), or an id that matches a saved embed.
I want to read EPUB files
EPUB is not supported in the free plugin. The EPUB reader is part of Flipset Pro.
Still stuck?
Free users: post in the support forum on WordPress.org or open an issue on GitHub. Pro customers: use the contact form and include your license email.