Flipbook for TYPO3

Flipbooks looked impressive in 2012 but cost performance and accessibility today

The page-turning effect was one of the most popular display formats for catalogs, annual reports and magazines on corporate websites. A PDF is split into individual pages, displayed in the browser as a book and flipped via mouse click or swipe gesture. The technology originated in the Flash era. Since the end of Flash (2020), flipbook solutions are based on JavaScript and Canvas. But the core idea has not changed: it is about visually simulating a physical document.

The problem: flipbooks are performance killers. A 40-page PDF is converted into 40 individual images (200 to 500 KB each), plus the JavaScript library (100 to 300 KB minified). Result: 10 to 20 MB payload for a single content element. On mobile devices, flipbooks are barely usable, screen readers cannot read the content, and Google does not index the text because it is embedded in images.

Typical use cases

Annual reports and financial statements. Board members want to show the annual report “as printed” on the website. The print agency delivers a PDF, the marketing team wants to put it online as-is. Flipbook seems like the easiest solution. Gosign recommends an alternative: prepare the report as an HTML page (searchable, accessible, responsive) and place the PDF as a download link alongside it. This requires more effort but delivers SEO value and accessibility.

Product catalogs with many pages. Industrial companies with 200-page catalogs use flipbooks as “browseable catalogs” on the website. Reality: users flip through a maximum of 5 to 10 pages before abandoning. A searchable HTML catalog with filters and product detail pages converts better. If the flipping effect is desired, a lightbox slider with the most important pages as previews is sufficient.

Real estate brochures and marketing materials. Real estate offices show property brochures as flipbooks to give prospects a feel for the printed document. Here, an embedded PDF viewer (pdf.js) without the flipping effect often suffices - it works on all devices and keeps the text searchable.

Technical architecture

The flipbook extension for TYPO3 (the successor to rflipbook) works in three steps. First, PDF.js renders the pages of the PDF into images in the browser; alternatively, the extension reads ready-made page images from a folder. Then a bundled jQuery flipbook plugin displays the pages as a book. The flipping effect is produced via CSS3 transforms and JavaScript animation.

The TYPO3 integration works as a content element: editor uploads a PDF, selects options (start page, thumbnail size, single-page mode), the frontend renders the flipbook. The extension stores no page images: in PDF mode the browser renders the pages, in folder mode they already sit in fileadmin.

Dependencies: the extension needs no PDF conversion on the server; only the automatic preview image of the first page is created by TYPO3 via ImageMagick or GraphicsMagick with Ghostscript. The JavaScript library is included as an asset. The bundled flipbook plugin needs jQuery - an additional performance penalty on modern websites.

Common problems and solutions

Preview image is not generated. Converting the first PDF page fails when Ghostscript is not installed, the wrong version is running or write permissions are missing for the output directory. Solution: check gs --version on the server, grant write permissions for the output directory to the webserver user, contact the provider on shared hosting.

Loading time over 5 seconds. An 80-page PDF generates dozens of high-resolution images. Solution: reduce image quality (72 dpi instead of 150 dpi for web display), implement lazy loading for pages outside the visible area, use WebP instead of PNG/JPEG. Or ask the fundamental question: is a flipbook really necessary?

Mobile devices show rendering errors. The flipping effect works only partially on touch devices. The 3D page-turn effect is barely visible on small screens, and the swipe gesture conflicts with browser scrolling. Solution: automatically fall back to a simple slider or the native PDF viewer on mobile devices.

Migration and version compatibility

The flipbook extension has limited support for current TYPO3 versions. The last stable version, 12.0.3, supports only TYPO3 v12. For v13 there is only a development branch without a release, for v14 nothing (as of September 2026). rflipbook, from which the extension evolved, is published neither in the TER nor on Packagist.

Gosign recommends replacing the flipbook with one of the following alternatives during a TYPO3 upgrade: a PDF viewer based on pdf.js (open source, no conversion needed, text remains searchable), HTML preparation of the content (maximum SEO impact, full accessibility) or a lightbox slider with selected pages as images (visual compromise, good performance). The migration is typically completed in 1 to 2 days because the content already exists as PDF and only the display format changes.

For companies that regularly publish new materials (quarterly customer magazines, annual reports), an automated workflow pays off: upload PDF, render server-side via pdf.js, generate preview images, extract full text for search. TYPO3 can automate this process via a scheduler task so editors only upload the PDF and the display happens automatically. The initial effort for this workflow is 3 to 5 development days but saves 2 to 4 hours of manual work with each new publication.

Another aspect is accessibility. Flipbooks are completely inaccessible to screen reader users because the text is embedded in images. The European Accessibility Act (EAA), in effect since June 2025, also applies to digital publications on websites through which companies sell products or services to consumers. The shift to HTML-based displays or pdf.js (which renders the original text) is therefore not just a performance question but also a legal necessity. Gosign checks during every relaunch project whether flipbooks or comparable image-based displays are present and proposes accessible alternatives wherever the legislation applies.