Skip to content

Troubleshooting Flipset

Fixes for a blank viewer, PDFs from other domains, slow large files and missing search results.

On this page
  1. The viewer is blank
  2. A PDF works on my site but fails from another domain
  3. A large PDF feels slow
  4. Site search does not find words from my PDF
  5. A PDF shows “Untagged”
  6. The embed shows “no file URL” or “Embed ID not found”
  7. I want to read EPUB files
  8. Still stuck?

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.

Find your product