Sawir Media Folders

How it works

Where folders appear

• Media → Library (grid view) : the full folder tree panel with drag & drop. The panel does not appear in list view.
• Media modals (post editor, featured image, galleries): the same folder tree, docked on the left of the file browser. Hidden on small screens.

The tree panel

• All files shows everything; Uncategorized shows files not in any folder.
• Folder counts include files in subfolders.
• Folders with subfolders show a ▾ arrow — click it to collapse or expand. Collapse state is remembered per browser.
• The « button in the panel header minimizes the whole panel to a slim strip (» restores it). Remembered per browser, applies to the grid and modals alike.
• Drag the panel’s right edge to resize it. The width is remembered per browser and shared between the grid and modals.
• New creates a top-level folder. Hover a folder for its actions: + new subfolder, ✎ rename, × delete.
• Rename inline: double-click a folder’s name (or click ✎ ), type the new name, press Enter. Esc cancels.
• A file lives in exactly one folder at a time.

Sorting

The Sort row under the panel header orders the files shown on the right — by date, modified, name, or author, ascending or descending. It applies to whichever folder (or All files) is selected. Sorting by file size isn’t offered: WordPress doesn’t store attachment sizes in a sortable way.

Putting files in folders

• Drag any file from the grid onto a folder — on the Media Library page or inside a media modal.
• To move several at once: Bulk select (or in a modal, just select multiple), pick files, drag the selection onto a folder.
• Drag files onto Uncategorized to remove them from their folder.

Moving and reordering folders

Drag a folder onto another folder. The drop position decides what happens:

• Top edge (line above): insert before that folder.
• Bottom edge (line below): insert after that folder.
• Middle (dashed outline): nest inside that folder, after its existing children.
• Dropping on All files or Uncategorized moves the folder to the top of the root level.
• Prefer buttons? Hover a folder: ↑ / ↓ move it among its siblings, ⇄ opens a dropdown to pick a new parent folder (or top level).
• A folder cannot be moved into its own subtree.
• Untouched folders sort alphabetically; once you drag one, its siblings keep your manual order.

Downloading a folder

Hover a folder and click ⬇ to download it as a zip. Subfolders are included as folders inside the zip; duplicate filenames are auto-renamed (photo.jpg, photo-2.jpg).

Deleting a folder

Files are kept and become uncategorized. Subfolders move up one level (to the deleted folder’s parent).

Automatic organization (for developers)

New uploads can be filed into folders automatically with the sawirmf_auto_folder filter. Return a folder path (created if missing), an existing folder ID, or null to leave the upload uncategorized. Nothing is auto-filed unless you add a rule — the default is off.

File PDFs into “Documents”, and WooCommerce product images into “Products”:

add_filter( 'sawirmf_auto_folder', function ( $folder, $att_id, $attachment ) { if ( 'application/pdf' === $attachment->post_mime_type ) { return 'Documents'; } if ( 'product' === get_post_type( $attachment->post_parent ) ) { return 'Products'; } return $folder; }, 10, 3 );

File blog images by year (“Blog/2026”):

add_filter( 'sawirmf_auto_folder', function ( $folder, $att_id, $attachment ) { if ( 'post' === get_post_type( $attachment->post_parent ) ) { return 'Blog/' . get_the_date( 'Y', $attachment ); } return $folder; }, 10, 3 );

Give each uploading user their own folder:

add_filter( 'sawirmf_auto_folder', function ( $folder, $att_id, $attachment ) { $user = get_userdata( $attachment->post_author ); return $user ? 'Users/' . $user->display_name : $folder; }, 10, 3 );

Notes:

• Paths are slash-separated and nest (“Clients/Acme/Logos” creates three levels as needed); existing folders are reused, never duplicated.
• Rules only run for uploads made while the plugin is active; existing files are untouched.
• Returning a folder ID that doesn’t exist is ignored (the upload stays uncategorized).