CatFolders Document Gallery & PDF Library

Opis

Document Gallery is a free extension for the CatFolders plugin that makes it easy to publish document libraries on your WordPress site.

With a single Gutenberg block (or simple shortcode), you can point to any media folder and instantly display its contents on a page.

In seconds, a folder of PDFs, Word docs, spreadsheets, ebooks, and more becomes a neat, browsable on-page gallery. No manual link-building required and no file links altered.

Visitors see each file as a clickable card (icon + title + first page image) and can open or download it without leaving the page.

📌 Documentation | View Demo of PDF gallery with first page thumbnails

Key Features

Grid & List Layouts
Display any media folder as a clean grid of cards or a classic table list. Each entry shows a file-type icon or PDF thumbnail alongside the file title and an optional description.

Instant Previews & Downloads
Click a file card to preview it in-page or trigger a download. Document Gallery automatically generates first-page thumbnails for PDFs, so visitors always have a visual reference.

Search, Sort & Filter
Built-in search and filtering let users narrow results by folder, file type, date, and more. Pagination and load-more buttons keep large collections fast and easy to browse.

Customizable File Details
Choose which columns to display: file size, updated date, type icon, a Download button, or custom notes. All output inherits your active theme’s styling for a polished, consistent look.

All Media Types Supported
Not just PDFs. Document Gallery works with Word, Excel, PowerPoint, images, audio, video, ebooks (EPUB, MOBI), and any custom file type stored in your WordPress media library. Suitable for any download-heavy site!

💥 New Feature: Nested Folders with Breadcrumb Navigation!

The CatFolders Document Gallery now supports multi-level folder structure, making it easier than ever to organize and present your documents. With intuitive breadcrumb navigation, your website visitors can quickly explore subfolders and find exactly what they need!

CatFolders Document Gallery support displaying all WordPress file types:

  • Documents: pdf, doc, ppt, odt, xls
  • Graphics: psd, svg
  • eBooks: epub, mobi, azw, azw3
  • Images: jpg, jpeg, png, gif, ico, webp
  • Audios: mp3, m4a, ogg, wav
  • Videos: mp4, mov, wmv, avi, mpg
  • Others: svg, zip, json, and custom file types

To get started with this WordPress PDF gallery plugin, simply follow these steps:

  1. Install CatFolders (free, or pro version)
  2. Install CatFolders Document Gallery (this plugin)
  3. Start organizing documents into folders
  4. Pick a folder to create WordPress gallery from folder
  5. Customize the gallery appearances and publish

💪 WHY YOU SHOULD USE DOCUMENT GALLERY BY CATFOLDERS?

It will save you a huge amount of time thanks to these built-in features:

  • Two customizable layouts: list and grid
  • Over 5 file details available:: title, file type, icon, file size, updated date, and download link
  • Automatically shows PDF first-page thumbnails
  • Supports all standard WordPress media file types
  • Fully mobile responsive
  • Clean, modern gallery design
  • Option to show or hide specific columns
  • Built-in file title search box
  • Sort files by size, title, file type, or last modified date
  • Flexible pagination settings
  • Click to preview, open in a popup, or download any file

It’s especially useful for WordPress websites that offer downloadable resources, such as:

  • eCommerce websites offering digital products or file downloads.
  • Membership sites providing gated access to exclusive files.
  • Schools or universities sharing study materials.
  • Companies providing white papers or reports.
  • Nonprofits sharing brochures and legal docs.

Happy gallery-ing 💖

Zrzuty ekranu

  • Collapsible document galleries from folders.
  • The Gutenberg block of CatFolders document gallery.
  • 3 steps to set up WordPress document gallery in Gutenberg or shortcode builder.
  • WordPress document gallery in grid view.
  • WordPress document file gallery in list view.
  • Sort, search, click to view, and download documents from WordPress document gallery.
  • Tabbed filterable gallery with PDF first page thumbnails.

Bloki

Wtyczka dodaje 1 blok.

  • CatFolders Document Gallery Display folders item in a document gallery.

Instalacja

  1. Upload the plugin files to the /wp-content/plugins/catfolders-document-gallery directory, or upload the zip file through the WordPress plugins screen.
  2. Activate the plugin through the Plugins screen in WordPress.
  3. Go to WordPress media library to start adding documents to your document category.
  4. In Gutenberg editor, add CatFolders Document Gallery block to create a WordPress PDF gallery, file gallery, and more!

Najczęściej zadawane pytania

How does the WordPress pdf gallery plugin work?

This free WordPress pdf gallery plugin adds a CatFolders Document Gallery block in Gutenberg. You can use it to create a WP document library on the front-end. Once you have published the documents and other files to the gallery, your website visitors can search, sort, preview, view all documents, or download files very quickly. It helps retain traffic and boost engagement on your WordPress website.

Can’t upload images or files to WordPress media library?

No worries, these things happen. Please check out how to troubleshoot WordPress media library not loading or upload documents to WordPress media library.

Is there a limit to the number of documents I can display on WordPress page/post?

There’s no limit to how many attachments and files you can add to a folder. Therefore, no limit on the number of documents per page/post! This CatFolders Document Gallery plugin is optimized with smart pagination so the users can go back and forth between the pages very quickly without reloading page.

Does it support hierarchical folders?

If you’re using CatFolders – WP Media Folders free version, which doesn’t create subfolders, it won’t be displaying multiple folders on the front-end. However, you can bulk-select folders using Ctrl/Command or Shift key and display all files contained in those folders.
Regarding showing the folder tree structure on the front-end, we are considering it and will implement it as soon as we can.

How to create a collapsible document gallery?

In Gutenberg, there’s a built-in block called Details and you can use it to create a collapsible section. Inside the section, just add a CatFolders Document Gallery block, and you will have collapsible lists of document galleries.

Can the document gallery display PDF first pages as thumbnails?

Yes, as long as your website’s server is properly configured with ImageMagick and GhostScript, which generates the first page image of PDF in the WordPress media library, it will be displayed on the front-end accordingly.

Can I request to add more features to this plugin?

So you want us to add further integrations such as Elementor pdf gallery, and others? To put it into consideration, please submit your ideas to CatFolders feature requests.

Recenzje

2026-04-30
I would like to leave a well-deserved 5-star review for the CatFolders support team. The assistance I received was outstanding: fast, clear, and highly professional. They not only helped me solve my issue, but also guided me step by step, providing a practical and effective solution that I was able to replicate on my own across multiple websites. What impressed me the most was their willingness to go the extra mile. They even implemented a custom solution to improve the user experience, making image previews work exactly as needed. Their support is not just reactive, but truly collaborative and solution-oriented. This level of attention and care is rare to find. Highly recommended — both the plugin and, above all, the people behind it. Thank you again for your excellent work!
2025-10-30
I was looking at manually creating a document library using standard WP blocks, but this plugin made it so much easier! I’m already using CatFolders for my media library and pages organization, so it was an easy decision to try this out. It worked out great! Very easy to add the documents to folders in the media library and then specify which folders are to show in the online library. Saved me loads of time. CatFolders was also very prompt when I had some errors showing in my debug log, fixing it the same day. I really appreciate that level of service.
2025-08-07 2 odpowiedzi
The plug-in is not really a full plug-in at all just an addon designed for the Pro version of their main plug-in. The functionality for nested folder display is non existent in the „free” version yet is it present in the UI and documentation. No problem with them doing that with a free plug-in but prominently mention that so time is not wasted trying to figure out why something presented as a function in the plug-in won’t actually be available without the pro version. Otherwise it’s just a bait and switch.
2025-06-26
What I thought was going to take Hours took only minutes with CatFolder. Archiving 57 years of PDF News Letters (over 240 total). Catfolder’s support team was also great helping me make a small tweak to the search field. This plugin worked seamless with ELEMENTOR!
2025-06-24
The support was amazing from the support group and quick response with helping with a couple of little issues. This plugin is easy to use and amazing and would recommend this plugin to anyone.
2025-06-19 8 odpowiedzi
Das CatFolders Document Gallery Plugin überzeugt zunächst durch seine einfache Integration und problemlose Funktionsweise im WordPress-Gutenberg-Editor. Dort arbeitet es zuverlässig und bietet eine übersichtliche Dokumentenverwaltung, die ohne weitere Anpassungen genutzt werden kann. Kritikpunkt: Elementor-KompatibilitätBei der Nutzung des Plugins mit Elementor, insbesondere über das Shortcode-Widget, treten jedoch schwerwiegende Fehler auf. Pro Seitenaufruf werden bis zu 16.427 Fehlermeldungen generiert – und das ausschließlich durch die Einbindung mit dem Elementor-Shortcode-Element. Im Debug-Log wird jeder Aufruf der betreffenden Seite mit einer neuen, massiven Fehlerflut dokumentiert. Konkrete Beobachtungen & Risiken: Problem tritt nur mit Elementor auf: Die gleiche Integration per Shortcode im Gutenberg-Editor bleibt fehlerfrei, das Problem ist also klar auf die Interaktion mit Elementor zurückzuführen. Technische Ursache: Offenbar können bestimmte Plugin-Funktionen im Rahmen des Elementor-Widgets nicht sauber ausgeführt werden (z.B. Initialisierung von Funktionen, Shortcode-Handling, ggf. Ajax- oder JS-Events). Performance-Risiko: Besonders kritisch ist die Tatsache, dass die Logdatei bei jedem Seitenaufruf anwächst. In Shared-Hosting-Umgebungen (ohne Root-Zugriff) kann dies sehr schnell zu einer explodierenden debug.log-Datei führen und den Server massiv belasten. Fehlermeldungen: Die Fehler im Log sind nicht nur kosmetisch, sondern können das gesamte WordPress-System beeinträchtigen, wenn die Datei unkontrolliert wächst. Workarounds getestet: Shortcode im Gutenberg-Editor funktioniert Shortcode im Elementor-Widget Fehlerflut Zwischenspeichern, Caching, Plugin-Deaktivierung, individuelle CSS/JS-Einbindung keine Lösung Fazit:Für WordPress-Nutzer, die ausschließlich mit Gutenberg arbeiten, ist das Plugin eine klare Empfehlung. Wer jedoch auf Elementor setzt, muss aktuell mit gravierenden Einschränkungen und Risiken rechnen. Das Problem ist klar reproduzierbar, umfassend dokumentiert und sollte dringend durch die Entwickler analysiert und behoben werden.
Przeczytaj 13 recenzji

Kontrybutorzy i deweloperzy

„CatFolders Document Gallery & PDF Library” jest oprogramowaniem open source. Poniższe osoby miały wkład w rozwój wtyczki.

Zaangażowani

Wtyczka „CatFolders Document Gallery & PDF Library” została przetłumaczona na 2 języki. Podziękuj tłumaczom za ich wkład.

Przetłumacz wtyczkę “CatFolders Document Gallery & PDF Library” na swój język.

Interesuje cię rozwój wtyczki?

Przeglądaj kod, sprawdź repozytorium SVN lub czytaj dziennik rozwoju przez RSS.

Rejestr zmian

Mar 17, 2026 – Version 2.0.5

  • Added: Korean language
  • Improved: Folder tree UI

Dec 10, 2025 – Version 2.0.4

  • Added: Document click-to-preview options
  • Improved: German translations
  • Improved: Tested up to WordPress 6.9

Oct 10, 2025 – Version 2.0.3

  • Fixed: Sort function

Aug 27, 2025 – Version 2.0.2

  • Added: Search Scope (Narrow, All)

May 7, 2025 – Version 2.0.1

  • Improved: Translation text in gallery shortcode

Dec 15, 2024 – Version 2.0.0

  • New feature: Multiple levels of folders with breadcrumb and nested folders
  • Fixed: The issue where the counter feature did not work when switching subfolders
  • Fixed: Search function

Jul 5, 2024 – Version 1.5.2

  • Added: Counter for the number of clicks to view/download file

May 31, 2024 – Version 1.5.1

  • Improved: Works with WP 6.1 and newer
  • Fixed: React Dom Deprecated in WP 6.2
  • Fixed: Document images cannot be disabled
  • Fixed: Searcher not working

May 31, 2024 – Version 1.5.0

  • Updated: Minimum WordPress requirement to version 6.2

May 29, 2024 – Version 1.4.9

  • Improved: The grid layout to eliminate excess space when disabling some columns
  • Fixed: CSS (remove background !important)

May 13, 2024 – Version 1.4.8

  • Improved: Remove Tabindex on Desktop, should be possible on mobile only
  • Fixed: Focus border not working for table-header
  • Fixed: Text of aria-description attribute

May 9, 2024 – Version 1.4.7

  • Fixed: Issue of sort by date

Mar 12, 2024 – Version 1.4.6

  • New feature: Thumbnails for PDF & other documents
  • Improved: Optimized performance by using jpg for better wp auto crop quality
  • Fixed: The preview section encounters an error when hiding/showing columns in the display field settings
  • Fixed: The aria-label attribute issue when using a screen reader

Feb 2, 2024 – Version 1.4.5

  • New feature: Shortcode for using document gallery with Classic Editor, WordPress classic themes, and page builders
  • Fixed: Missing translate and German translation does not work
  • Improved: User experience with search feature
  • Improved: CSS

Dec 21, 2023 – Version 1.4.4

  • Fixed: Accessibility (contrast low, target size for icon, aria-label)
  • Fixed: Translation strings missing
  • Updated: POT file
  • Improved: User experience (remove empty divs, some CSS for table)

Nov 16, 2023 – Version 1.4.3

  • Updated: Translation in PO file

Nov 15, 2023 – Version 1.4.2

  • Updated: text domain (from catf-dg to catfolders-document-gallery)

Nov 4, 2023 – Version 1.4.1

  • Updated: POT file
  • Fixed: Wrong link generated

Nov 3, 2023 – Version 1.4

  • Fixed: Some CSS errors related to the position of displaying elements when change its position (search bar, layout icon, pagination)
  • Fixed: Displaying empty element when icon and title library are hidden

Oct 6, 2023 – Version 1.3

  • Fix: Accessibility
  • Add: Support German language

Sep 22, 2023 – Version 1.2

  • Add: New order by size (GB > MB > KB > Byte)
  • Update: Plugin detail (Remove “By” duplication in wp.org)
  • Update: Hide “Item per pages” in Mobile table
  • Fix: Issue with sorting files
  • Fix: Button alignment in grid view
  • Fix: CSS conflict
  • Fix: Accessibility (aria attribute)

Jul 24, 2023 Version 1.1

  • Improve code

Jun 20, 2023 – Version 1.0

  • Initial Release