Flexa Media Folders

Flexa Media Folders adds a hierarchical, drag-and-drop folder tree to the WordPress Media Library. Group images, videos, documents and any other attachment into nested folders, then filter the library to a single folder with one click – in the grid view, the list view, and the media picker inside the post editor.

Folders are stored in two dedicated, indexed database tables, so your wp_term* tables stay clean and the tree loads fast even with thousands of files.

Features

• Hierarchical folder tree – create unlimited nested folders, rename them, and reorder them by drag-and-drop.
• Drag attachments into folders – drag a grid thumbnail or a list-view row straight onto a folder. Select several items first and the whole selection moves at once.
• Works everywhere the Media Library does – the folder sidebar appears on the Media grid, the list view (upload.php), and the media modal in the block editor, the Classic Editor and on taxonomy term screens.
• One-click filtering – click a folder to filter the library to it, plus built-in “All files” and “Uncategorized” views. On the list view the active folder is kept in the URL, so it survives paging and reloads.
• Keyboard control – the tree is a real ARIA tree: arrow keys walk it, Left/Right collapse and expand, Home/End jump to the ends, and typing a few letters jumps to a folder by name. F2 renames, Cmd/Ctrl+X cuts, Cmd/Ctrl+V pastes, and Cmd/Ctrl+Backspace opens the delete confirmation.
• Inline rename – click the name of an already-selected folder (Finder style) and edit it in place. Enter saves, Esc cancels.
• Color labels – assign one of 18 colors to any folder from the right-click menu to spot it at a glance.
• Full context menu – New Folder, Rename, Cut, Paste, Delete and Change Color, all from a right-click.
• Bulk folder creation – paste an indented list of names and get the whole subtree in one step.
• Import from another folder plugin – bring an existing tree over from FileBird, Real Media Library, CatFolders, Folders (Premio) or Media Library Organizer, including the attachment assignments. The source plugin’s own data is left untouched.
• Pick the upload target – choose which folder new uploads land in from the uploader itself, without leaving the screen.
• File counts – each folder can show how many attachments it contains, counting its subfolders too if you prefer (both are Settings toggles).
• Folder search – filter the folder tree as you type.
• Settings page – choose a default folder for new uploads (none / last used / a specific folder), set the folder sort order, toggle file counts, exclude specific post types or taxonomies from showing the sidebar, and tune the sidebar’s icon size, text size and corner radii.
• Safe SVG uploads – optional, off by default. When you switch it on, every uploaded SVG is sanitized (scripts, event handlers and remote references stripped) before it is stored, and the library renders the SVG itself instead of a generic file icon.
• Multisite ready – each site in a network gets its own folder tree. Tables are provisioned when a site is created and removed when it is deleted.
• Dark mode – the tree automatically follows your WordPress admin color scheme.
• Accessible – full ARIA tree semantics, keyboard navigation, and visible focus styles.
• Translation ready – every string is internationalized, 29 locales ship with the plugin, and a .pot template is bundled.
• REST API – all screens are powered by a REST API under /wp-json/flexa-mf/v1/, so external integrations and your own code can read and manage folders too.
• WP-CLI – manage folders, run an import, and reset plugin data from the command line with wp flexa-mf.
• Clean uninstall – a Settings danger zone (and wp flexa-mf reset) wipes all plugin data on demand; uninstalling the plugin drops its tables. Your media files are never touched.

Source code for compiled JavaScript and CSS

The plugin ships with minified/compiled JavaScript and CSS in assets/dist/. The human-readable source code for these assets is publicly available and maintained at:

https://github.com/flexatech/flexa-media-folders

The assets are built with pnpm and Vite. To build them from source:

1. pnpm install
2. pnpm build (production build; the Vite config lives at apps/admin/vite.config.ts)

Use pnpm dev for a watched development build.

The only bundled third-party PHP library is enshrined/svg-sanitize (GPL-2.0-or-later), in vendor/, used to sanitize SVG uploads. It is installed with Composer from https://github.com/darylldoyle/svg-sanitizer.

External services

All of your folders and media stay on your own site. The plugin connects to one external service, only in the admin area, for the single reason below.

Deactivation feedback (Flexa Product Intelligence)

When you go to deactivate Flexa Media Folders on the Plugins screen, a short optional survey asks why. It is served by Flexa’s product intelligence service at https://product-intelligence.flexacommerce.com. It runs only in the admin, on wp-admin/plugins.php, never on the front end, and never blocks or delays deactivation. What is sent, and when:

• On opening the Plugins screen: a request to /api/v1/config (product slug and tier) to load the survey configuration. The response is cached for 6 hours.
• When you deactivate or interact with the survey: the reason you pick and any optional message you type, sent to /api/v1/deactivations, /api/v1/events, /api/v1/feedback, /api/v1/feature-requests and /api/v1/recovery-events.

Every request includes an anonymous per-site identifier (a random UUID), the plugin version and tier, and by default your WordPress version, PHP version and locale. No email, site domain, user identity or raw IP is collected. To stop sending environment data, use add_filter( 'flexa_mf/deactivation_survey/config', function ( $c ) { return array( 'collect_environment' => false ) + $c; } );. To disable the survey entirely, use add_filter( 'flexa_mf/deactivation_survey/enabled', '__return_false' );.
Terms of Service: https://flexacommerce.com/pages/terms
Privacy Policy: https://flexacommerce.com/pages/privacy