soderlind / virtual-media-folders Public

Notifications You must be signed in to change notification settings
Fork 0
Star 8

Virtual Media Folders brings virtual folder organization to your WordPress Media Library. Organize your media files into hierarchical folders without moving files on disk—folders are virtual, so your URLs never change.

8 stars 0 forks Branches Tags Activity

Notifications

Name		Name	Last commit message	Last commit date
Latest commit History 179 Commits
.github		.github
.phpunit.cache		.phpunit.cache
.wordpress-org		.wordpress-org
assets		assets
build		build
docs		docs
languages		languages
src		src
tests		tests
vendor		vendor
.distignore		.distignore
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
README.md		README.md
composer.json		composer.json
composer.lock		composer.lock
i18n-map.json		i18n-map.json
package-lock.json		package-lock.json
package.json		package.json
phpunit.xml.dist		phpunit.xml.dist
readme.txt		readme.txt
uninstall.php		uninstall.php
virtual-media-folders.php		virtual-media-folders.php
vitest.config.js		vitest.config.js
webpack.config.js		webpack.config.js

Repository files navigation

Virtual Media Folders

Virtual folder organization for the WordPress Media Library.

Description

Virtual Media Folders brings folder organization to your WordPress Media Library. Organize your media files into hierarchical folders without moving files on disk—folders are virtual, so your URLs never change.

Click to watch demo video on YouTube

Features

Virtual Folders – Create hierarchical folder structures to organize media
Drag & Drop – Move media between folders with drag and drop
Sticky Sidebar – Folder navigation stays visible while scrolling
Gutenberg Integration – Filter media by folder in the block editor
Bulk Actions – Move multiple media items at once
Keyboard Accessible – Full keyboard navigation with screen reader support
Internationalized – Translation ready (Norwegian Bokmål included)

Requirements

WordPress 6.8+
PHP 8.3+

Installation

From GitHub

Download `virtual-media-folders.zip`
Go to Plugins > Add New > Upload Plugin
Upload the zip file and activate

From WordPress.org

Go to Plugins > Add New
Search for "Virtual Media Folders"
Click Install Now and Activate

Usage

Organizing Media

Go to Media > Library
Click the folder icon to show the sidebar
Use + to create folders
Drag media onto folders to organize
Click a folder to filter the view

Settings

Go to Media > Folder Settings to configure:

Setting	Description
Show "All Media"	Display "All Media" option in sidebar
Show "Uncategorized"	Display folder for unassigned media
Jump to folder after move	Navigate to target folder after moving
Default folder for uploads	Auto-assign new uploads to a folder

Block Editor

When inserting media from a block:

Open the Media Library modal
Use the folder sidebar to filter
Select your media

Documentation

Accessibility – Keyboard navigation and screen reader support
Development – Setup, API reference, hooks, and contributing

License

Virtual Media Folders is free software licensed under the GPL v2 or later.

Copyright 2025 Per Soderlind