Title: KooKoa Folders – Media Library Folders &amp; File Organizer
Author: KooKoa
Published: <strong>27, Abril de 2026</strong>
Last modified: 2, Xunu de 2026

---

Guetar plugins

![](https://ps.w.org/kookoa-folders/assets/banner-772x250.png?rev=3516950)

![](https://ps.w.org/kookoa-folders/assets/icon-256x256.gif?rev=3516170)

# KooKoa Folders – Media Library Folders & File Organizer

 By [KooKoa](https://profiles.wordpress.org/adamolussana/)

[Download](https://downloads.wordpress.org/plugin/kookoa-folders.1.4.0.zip)

 * [Details](https://ast.wordpress.org/plugins/kookoa-folders/#description)
 * [Reviews](https://ast.wordpress.org/plugins/kookoa-folders/#reviews)
 *  [Installation](https://ast.wordpress.org/plugins/kookoa-folders/#installation)
 * [Development](https://ast.wordpress.org/plugins/kookoa-folders/#developers)

 [Support](https://wordpress.org/support/plugin/kookoa-folders/)

## Description

KooKoa Folders adds a folder sidebar to the WordPress Media Library. You can create
folders, nest them into subfolders, and move files around with drag and drop. It
also ships with unlimited smart folders that auto-populate from rules you define—
file type, size, date, dimensions, tags, and more — so the library stays tidy as
it grows.

👉 [**TRY THE LIVE DEMO**](https://demo.kookoa.com/live) ☝️ — Instant access, no
account needed

Folders are virtual. They are stored as a private WordPress taxonomy and attached
to your media items, so your files on disk are never moved and existing image URLs
keep working. If you deactivate the plugin your Media Library keeps running as if
nothing happened.

#### 🗂️ Organization

 * Unlimited folders and subfolders in the Media Library
 * Drag and drop attachments between folders
 * Auto-assign new uploads to the folder you are currently in
 * Item count per folder
 * Folder filter on the Media Library list view

#### ⚡ Smart Folders

 * Unlimited smart (rule-based) folders, auto-populated as your Media Library grows
 * Combine multiple rules per folder with AND logic — file type, size, dimensions,
   date, author, status, search, tags, and more
 * Live counts cached per folder, refreshed automatically when items change
 * Pin, lock, color and icon support — same UX as regular folders

#### 🌈 Cosmetics

 * Custom folder colors
 * Custom folder icons with emoji picker
 * Pin folders to the top of the tree
 * Lock folders to prevent accidental rename, color, icon or delete

#### 🔍 Navigation

 * Resizable, sticky folder sidebar
 * Search and sort the folder tree
 * Breadcrumb bar and subfolder cards
 * Smart Startup Folder — open the Media Library on the last folder you used, or
   on a fixed folder of your choice
 * Keyboard shortcuts for common actions
 * Mobile responsive layout

#### 🔄 Bulk operations

 * Bulk Organize mode — select multiple attachments and move them into a folder 
   in one click
 * Download a folder (and all its subfolders) as a single ZIP archive
 * Download just the selected items as a ZIP, straight from the Bulk Organize toolbar
 * Upload a folder structure from your computer and have the subfolders recreated
   automatically
 * Export and import the folder structure as JSON, with Merge or Replace modes

#### 📊 Insights

 * Hover tooltip on media items showing filename, size and dimensions
 * Optional EXIF fields in the hover tooltip — camera, aperture, shutter, ISO, focal
   length

#### 🛡️ Access control

 * Role-based access — pick which WordPress roles can use the folder sidebar

#### 🔒 Privacy

 * Self-hosted font, no Google Fonts call
 * No external scripts, no trackers, no analytics
 * No frontend assets are loaded for regular visitors; builder/editor integrations
   load only when an authorized editor opens a supported visual builder

#### ✅ Works with

The folder sidebar is available inside:

 * The WordPress Media Library list and grid views
 * The block editor (Gutenberg) media modal
 * The Classic Editor media modal
 * Divi 4 and 5 media modals
 * Elementor media modal
 * WooCommerce product gallery media modal

#### 🔁 Migrate from other folder plugins

Already using another folder plugin? Switch in one click. KooKoa Folders detects
existing folder structures directly from your database and rebuilds the full tree
inside the KooKoa sidebar — with file assignments intact, no JSON export, no rebuilding
from scratch.

Supported sources:

 * **FileBird** (Ninja Team)
 * **Folders** (Premio)
 * **Real Media Library** (devowl.io)

A subtle hint inside the Media Library surfaces the importer when one of these plugins
is detected, so you find it without going hunting through Settings. After a successful
import, the source plugin can be deactivated with one button — your KooKoa folder
structure keeps living independently.

#### 🚀🚀🚀 Pro add-on

👉 [**TRY THE LIVE DEMO**](https://demo.kookoa.com/live) ☝️

🚀 Folders for Posts & Pages
 🚀 Folders for Custom Post Types 🚀 AI Image Generator(
text-to-image) 🚀 AI Image Editor (text-guided edits) 🚀 WebP / AVIF Converter 🚀
Replace Media (same name or rename) 🚀 Watermark Images (logo or text) 🚀 Clean 
Unused Media 🚀 Find Duplicate Media (byte-exact + perceptual hash) 🚀 Image Editor(
crop, rotate, filters, resize) 🚀 Media Stats Dashboard 🚀 Priority Email Support

#### 💻 Use cases

A few real-world setups where KooKoa Folders earns its keep:

 * **Bloggers and content writers** — keep every blog image, post screenshot, hero
   photo, video clip and audio file inside dedicated media folders. Drag and drop
   assets between folders, filter the media library by folder, and find the right
   image for tomorrow’s article in seconds instead of scrolling past 2,000 thumbnails.
 * **WordPress photographers and photo studios** — split your media library by shoot
   type (portraits, weddings, real estate, landscapes, nature, family), by client,
   by year, or by location. Pin your active project to the top, lock the archive
   against accidental edits, and let smart folders auto-collect images by date, 
   file size or alt text.
 * **WooCommerce shop owners and e-commerce managers** — organize product images
   into folders that mirror your catalog (apparel, footwear, accessories, electronics).
   Drag and drop new product photos straight from upload into the right SKU folder,
   and use smart folders to auto-group every PNG, JPEG or WebP above a certain size
   for quality audits.
 * **Web designers, web developers and freelance agencies** — separate site assets
   per project, per page section or per client (logos, mockups, illustrations, icon
   sets, screenshots). Folder colors and custom icons turn the media library into
   a navigable workspace even when you sit on thousands of files.
 * **Online publishers, magazines and editors** — file every image per issue, per
   article, per author or per topic. Smart folders auto-collect everything uploaded
   this week, this month, or by a specific contributor — no manual sorting needed.
 * **Real estate, hospitality and listings sites** — one folder per property or 
   per location, subfolders per room, view or photoshoot. Bulk upload an entire 
   shoot, drag the keepers into the listing folder, and skip the rest. Color-code
   your busiest property folders so the right one stands out at a glance.
 * **Course creators and membership sites** — split lesson screenshots, video thumbnails
   and downloadable PDFs into folders per course, per module or per lesson. Find
   the right cover image without scrolling past fifty unrelated lessons.
 * **Marketing agencies, design studios and creative teams** — one WordPress Media
   Library, many clients. A folder per brand keeps work tidy, role-based access 
   keeps clients out of each other’s assets, and the export/import tool ships a 
   folder tree to a new project in a single JSON file.

### Open Source Libraries

KooKoa Folders is built on top of these open source projects. Thanks to their authors
for sharing their work with the community.

 * **jsTree** v3.3.16 by Ivan Bozhanov (vakata) — MIT License
    Website: https://
   www.jstree.com/
 * **Share Tech Mono** by Carrois Apostrophe (Ralph du Carrois) — SIL Open Font 
   License 1.1 — https://www.carrois.com/
    Self-hosted monospace font used throughout
   the interface. No Google Fonts CDN.

For everything else, KooKoa Folders uses the libraries that already ship with WordPress
core — **jQuery**, **jQuery UI** (Draggable, Droppable, Sortable) and **Dashicons**—
instead of bundling its own copies.

### Credits

KooKoa Folders is designed and developed by Adamo Lussana — https://www.kookoa.com

## Screenshots

 * [[
 * Media library folders
 * [[
 * Folder actions and dialogs
 * [[
 * Smart Folder rule builder
 * [[
 * General Settings
 * [[
 * Context Menu Settings
 * [[
 * Colors & Icons Settings
 * [[
 * Export & Import Settings
 * [[
 * Mobile view

## Installation

 1. In your WordPress admin, go to **Plugins  Add New**.
 2. Search for **KooKoa Folders**.
 3. Click **Install Now**, then **Activate**.
 4. Open the **Media Library** — the folder sidebar will appear on the left.
 5. Click **+ Folder** in the sidebar header to create your first folder, then drag
    items into it.

To configure the plugin, go to **KooKoa Folders** in the WordPress admin menu. You
can set the default sidebar width, change the color palette and icon set, enable
keyboard shortcuts, adjust the context menu, pick which roles can use the plugin,
and more.

**Manual installation**

 1. Download the plugin zip.
 2. Go to **Plugins  Add New  Upload Plugin** and upload the zip.
 3. Activate the plugin.

## FAQ

### Does KooKoa Folders move files on disk?

No. Folders are virtual. They are stored as a private WordPress taxonomy and attached
to media items. Your files on the server keep their original paths, so existing 
image URLs in your content never break.

### Will deleting a folder delete my files?

No. Deleting a folder only removes the folder itself. The media items inside it 
become uncategorized and stay in the Media Library.

### What happens if I deactivate the plugin?

Your folders stay in the database. When you reactivate the plugin, everything is
back where it was. If instead you use **Delete** from the Plugins screen, all plugin
data (folders, colors, icons, pin and lock state, settings) is removed cleanly.

### Does the plugin load anything from the internet?

No. The font used by the plugin interface is bundled inside the plugin and served
from your own site — no Google Fonts CDN, no external scripts, no analytics.

### Does it affect my site frontend or performance?

The plugin loads on the Media Library, on its own settings page, and inside the 
media modal — including when an authorized editor opens a supported visual builder
such as Divi or Elementor. Regular visitors get nothing extra: no CSS, no JavaScript,
no database queries.

### How many smart folders can I create?

As many as you need. KooKoa Folders ships with unlimited smart folders. Each folder
combines multiple rules with AND logic and auto-populates as new items match.

## Reviews

![](https://secure.gravatar.com/avatar/345cf5d76ba73a42afed81f0fb924c94cee687d7c5864d1992022f924dd6a422?
s=60&d=retro&r=g)

### 󠀁[The best file browser for WP](https://wordpress.org/support/topic/the-best-file-browser-for-wp/)󠁿

 [matrixino](https://profiles.wordpress.org/matrixino/) 30, Abril de 2026

This is the best file browser for WP hands down. Simply perfect!

 [ Read all 1 review ](https://wordpress.org/support/plugin/kookoa-folders/reviews/)

## Contributors & Developers

“KooKoa Folders – Media Library Folders & File Organizer” is open source software.
The following people have contributed to this plugin.

Contributors

 *   [ KooKoa ](https://profiles.wordpress.org/adamolussana/)

“KooKoa Folders – Media Library Folders & File Organizer” has been translated into
8 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/kookoa-folders/contributors)
for their contributions.

[Translate “KooKoa Folders – Media Library Folders & File Organizer” into your language.](https://translate.wordpress.org/projects/wp-plugins/kookoa-folders)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/kookoa-folders/), check
out the [SVN repository](https://plugins.svn.wordpress.org/kookoa-folders/), or 
subscribe to the [development log](https://plugins.trac.wordpress.org/log/kookoa-folders/)
by [RSS](https://plugins.trac.wordpress.org/log/kookoa-folders/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.4.0

 * Performance: the folder sidebar loads faster on large media libraries. The “Uncategorized”
   counter and the per-folder item counts no longer load every attachment ID into
   memory on each sidebar refresh, and the per-folder counts now run as a single
   batched query instead of one query per folder.
 * Performance: migrating from another folder plugin (FileBird, Folders by Premio,
   Real Media Library) is faster on large libraries — folder counts are recalculated
   once when the import finishes instead of after every individual file assignment.
 * Hardening: the folder reorder action now validates every sibling folder ID against
   its taxonomy before saving the order, so a crafted request cannot write folder
   metadata onto unrelated terms.
 * Hardening: uninstalling the plugin now also removes the temporary ZIP-download
   workspace (uploads/kookoawpf-tmp/), so deleting KooKoa Folders leaves nothing
   behind.

#### 1.3.0

 * New: WooCommerce “Category” and “Tag” rules for Smart Folders — auto-group products
   by their product category or product tag, alongside the existing Stock status
   rule. Visible only on the product custom post type when WooCommerce is active.
 * Improvement: minor admin UI refinements.

#### 1.2.0

 * Fix: smart folders are now preserved across JSON export and import. The export
   used to ship structure + metadata but skip the rule payload entirely, so re-importing
   a backup or running a “Replace all” silently demoted every smart folder in the
   tree to a plain folder, wiping its automation rules. The export now serialises
   the `is_dynamic` flag and the rules alongside the rest of the tree, and the import
   re-applies both on the new terms.
 * New: keyboard shortcut Alt + B toggles Bulk Organize mode from anywhere it’s 
   available (Media Library grid + list, Posts, Pages and any folder-enabled custom
   post type). Press it again — or press Esc with the bulk toolbar open — to exit.
   Both shortcuts now appear in the Keyboard Shortcuts dialog (Alt + K) under “Bulk
   Organize” and “Close Modal / Exit Bulk Mode”.
 * Improvement: minor admin UI refinements.

#### 1.1.2

 * Compatibility: tested with WordPress 7.0 (released May 2026). The retro-dark 
   sidebar, modals and bulk-organize toolbar now neutralize the WP 7.0 Modern admin
   theme overrides that were inflating our buttons to 40px, breaking dashicon rendering,
   and pulling icons out of alignment.
 * Fix: Smart Startup Folder “Last opened folder” mode now reliably restores the
   last visited folder on page load. A latent regression in the Settings save path
   was persisting an empty post-types list, which then blocked the AJAX that records
   navigation. Both the save serializer and the AJAX validator have been hardened.
 * Improvement: minor admin UI refinements.

#### 1.1.1

 * New: WooCommerce “Stock status” rule for Smart Folders — auto-group products 
   by In stock, Out of stock, or On backorder. Visible only on the product custom
   post type when WooCommerce is active.
 * Hardening: uninstall now sweeps every plugin-owned option and user meta key, 
   including the post-1.0 additions (install timestamp, migration importer flags,
   the permanently-hide-migrate-section flag, per-user dismiss flags for dashboard
   notices and the Rate Us card). Deleting KooKoa Folders truly leaves zero traces
   behind.
 * Hardening: Smart Startup Folder “Specific folder” preference now verifies that
   the saved folder still exists in the matching taxonomy before storing it, so 
   a deleted folder no longer leaves a stale reference in user meta.
 * Hardening: download Content-Disposition HTTP header now passes the filename through
   sanitize_file_name() as defense-in-depth against control-character injection.
 * Improvement: minor admin UI refinements.

#### 1.1.0

 * New: Migration importer for FileBird (by Ninja Team), Folders (by Premio) and
   Real Media Library (by devowl.io). Detects existing folders straight from your
   database and rebuilds the full tree, with file assignments, inside KooKoa Folders
   in one click. No JSON export needed, no rebuilding from scratch. Optional one-
   click deactivation of the source plugin after a successful import. Data-driven:
   imports keep working even when the source plugin section has been partially disabled
   in its own settings.
 * New: Sidebar hint in the Media Library that surfaces detected folder plugins 
   and links straight to the importer.
 * New: Architecture ready for more importers. HappyFiles, Enhanced Media Library,
   Wicked Folders and others can be added in a few lines each.
 * Improvement: minor admin UI refinements.

#### 1.0.4

 * New: Dutch translation bundled (nl_NL).
 * Improvement: minor admin UI refinements.

#### 1.0.3

Translations + bug fix release.

 * New: Polish translation bundled (pl_PL).
 * New: Brazilian Portuguese translation bundled — also covers European Portuguese(
   pt_PT) and other Portuguese-speaking locales (pt_AO, pt_MZ and others) via automatic
   locale fallback.
 * Fix: “Sidebar width” in Settings  General now applies immediately to the admin
   who saves it, and the field always reflects the width currently on screen (drag-
   resized value if any, else the site-wide default).
 * Removed: “Sticky sidebar” toggle in Settings  General — the toggle had no effect
   since the folder sidebar was always pinned regardless of the setting. Sidebar
   behavior is unchanged for all users.

#### 1.0.2

Translations release.

 * New: Italian translation bundled.
 * New: Spanish translation bundled — covers Spain plus all Latin American Spanish
   variants (es_MX, es_AR, es_CL, es_CO, es_VE, es_PE and others) via automatic 
   locale fallback.
 * New: French translation bundled — covers France, Belgium, Canada, Switzerland
   and other Francophone locales via automatic locale fallback.
 * New: German translation bundled — covers Germany, Austria, Switzerland and other
   German-speaking locales via automatic locale fallback.
 * New: Japanese translation bundled.
 * Improvement: smart locale fallback — when a region-specific .mo is not present(
   e.g. es_MX) the plugin now loads the generic language file (es) instead of leaving
   strings untranslated.
 * Improvement: the Force English toggle now appears for users on regional locale
   variants whenever a generic fallback translation is bundled.

#### 1.0.1

Bug fix release.

 * Fix: media modal “Load more” no longer resets the grid back to the first page.
 * Fix: downloading a single selected file now reliably saves to disk instead of
   occasionally opening it inline in the browser.
 * Fix: “Download ZIP” entry no longer appears in the folder context menu on Posts,
   Pages and Custom Post Types — Media Library only.
 * Fix: smart folders with two file extension rules (e.g. avif + webp) now return
   the union of both, not just one extension.
 * Improvement: smart folder rules split per post type — Media gets a clearer “Text
   contains (Title+Caption+Desc.)” label plus a new “Alt Text contains” rule; Posts/
   Pages/CPT get a “Title contains” rule that searches post titles only.
 * Improvement: folder bulk toolbar now hides Pin/Lock buttons when the matching
   context-menu entries are disabled in Settings, so the actions stay reversible
   from a single place.
 * Polish: replaced three book emojis in the Folders icon category with new icons
   that don’t duplicate the Documents category.

#### 1.0.0

Initial release on WordPress.org.

 * Unlimited folders and subfolders in the Media Library.
 * Unlimited smart folders (rule-based, auto-populated, multiple rules with AND 
   logic).
 * Drag and drop attachments into folders.
 * Auto-assign new uploads to the current folder.
 * Custom folder colors and emoji icons.
 * Pin and lock folders.
 * Resizable, sticky sidebar with search, sort and keyboard shortcuts.
 * Breadcrumb bar, subfolder cards, Smart Startup Folder.
 * Mobile responsive layout.
 * Bulk Organize mode.
 * Download a folder (with all subfolders) or just selected items as a ZIP archive.
 * Upload a folder structure from your computer.
 * JSON export and import of the folder structure (Merge or Replace).
 * Metadata and EXIF tooltip on hover over media items.
 * Role-based access control.
 * Self-hosted font, admin-only, no frontend footprint.
 * Media modal integration with Gutenberg, Classic Editor, Divi 4/5, Elementor, 
   and WooCommerce product galleries.

## Meta

 *  Version **1.4.0**
 *  Last updated **6 díes ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.2 or higher **
 *  Tested up to **7.0**
 *  PHP version ** 7.4 or higher **
 *  Languages
 * [English (US)](https://wordpress.org/plugins/kookoa-folders/), [French (France)](https://fr.wordpress.org/plugins/kookoa-folders/),
   [German](https://de.wordpress.org/plugins/kookoa-folders/), [Italian](https://it.wordpress.org/plugins/kookoa-folders/),
   [Japanese](https://ja.wordpress.org/plugins/kookoa-folders/), [Polish](https://pl.wordpress.org/plugins/kookoa-folders/),
   [Portuguese (Brazil)](https://br.wordpress.org/plugins/kookoa-folders/), [Russian](https://ru.wordpress.org/plugins/kookoa-folders/)
   y [Spanish (Spain)](https://es.wordpress.org/plugins/kookoa-folders/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/kookoa-folders)
 * Tags
 * [file manager](https://ast.wordpress.org/plugins/tags/file-manager/)[folders](https://ast.wordpress.org/plugins/tags/folders/)
   [media](https://ast.wordpress.org/plugins/tags/media/)[media folders](https://ast.wordpress.org/plugins/tags/media-folders/)
   [media library](https://ast.wordpress.org/plugins/tags/media-library/)
 *  [Advanced View](https://ast.wordpress.org/plugins/kookoa-folders/advanced/)

## Ratings

 5 out of 5 stars.

 *  [  1 5-star review     ](https://wordpress.org/support/plugin/kookoa-folders/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/kookoa-folders/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/kookoa-folders/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/kookoa-folders/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/kookoa-folders/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/kookoa-folders/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/kookoa-folders/reviews/)

## Contributors

 *   [ KooKoa ](https://profiles.wordpress.org/adamolussana/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/kookoa-folders/)