WP Media Directories
Check compatibility before you buy
Physical folders are powerful and opinionated. Here's what works, what conflicts, and what to ask us about.
WP Media Directories requires WordPress 6.0+ and PHP 7.4+. It organizes real directories under the site's upload basedir via WordPress upload APIs. It hard-conflicts with FileBird and Media Library Plus folder UIs. It is per-site on multisite. Custom upload locations work; full offload-to-object-storage setups need careful evaluation.
Requirements
| Item | Requirement |
|---|---|
| WordPress | 6.0+ |
| PHP | 7.4+ |
| Capability (use tree) | upload_files |
| Capability (settings/schedule) | manage_options |
| Background jobs | Action Scheduler (bundled if needed) |
Works well
- Standard and custom upload locations via wp_upload_dir()
- Media Library grid, list, and attachment modal
- Multisite: per site (own basedir, settings, tree)
- Sites that can create directories on the uploads filesystem
Hard conflicts
If these are active, WP Media Directories shows an admin notice and does not mount its folder UI.
- FileBird, FileBird Pro, FileBird Lite
- media-library-plus, media-library-folders, MaxGalleria media library
Clear expectations
| Topic | Guidance |
|---|---|
| Object storage / offload | Assumes real directories under upload basedir. Fully offloaded setups may be unsupported or partial. Contact before purchase. |
| CDN rewriting | CDN in front of baseurl is usually fine; Rewrite updates site content URLs, not every CDN purge rule. |
| Page builders / ACF fields | Rewrite v1 updates post_content + post_excerpt (+ attachment meta). Not postmeta, widgets, options, or builder JSON. |
| Realtime FS watchers | Not supported: use Reconcile / Sync now. |
Compatibility FAQ
Can I use this with FileBird?+
No, not at the same time. Deactivate FileBird before activating WP Media Directories.
Custom uploads folder?+
Yes, if WordPress reports it via wp_upload_dir().
Multisite network-wide tree?+
Not in v1; license and configure per site.
WooCommerce / Elementor?+
Media modal works; builder-stored URLs may need manual care until rewrite scope expands.
WP Media Directories
Compatible with your stack? Get the full product.
Every feature on every plan. 14-day money-back guarantee.