Folder Manager

The Folder Manager module lets you organize posts, pages, custom post types, and media files into hierarchical folders with drag-and-drop functionality. Create unlimited folders, nest them for better organization, and quickly filter content—making large content libraries easier to manage and navigate.

How to use

To enable the Folder Manager module:

1. Click on the “Content Management” category
2. Search or scroll to locate the Folder Manager module
3. Click on the switch to enable
4. The folder sidebar will appear on enabled post type list screens

What’s next?

Use this module to organize content into folders for:

• Media Library (available in free version)
• Posts, pages, and custom post types (Pro version only)

You can create hierarchical folder structures with unlimited nesting, drag and drop items between folders, and filter list views by folder. Items can be assigned to one folder at a time or remain uncategorized.

1. Managing folders

Creating folders

From the sidebar:

1. Navigate to any enabled post type list screen (e.g., Media Library, Posts)
2. Click the + button in the folder sidebar header
3. Enter a folder name
4. Click Save

Creating nested folders:

1. Hover over an existing folder
2. Click the folder actions menu (three dots)
3. Select Add Child Folder
4. Enter the subfolder name
5. Click Save

Renaming folders

1. Hover over the folder you want to rename
2. Click the folder actions menu
3. Select Rename Folder
4. Enter the new name
5. Click Save

Moving folders

1. Drag a folder to a new position in the hierarchy
2. Drop it on another folder to make it a child, or between folders to reorder
3. The folder structure updates automatically

Deleting folders

1. Hover over the folder you want to delete
2. Click the folder actions menu
3. Select Delete Folder
4. Confirm the deletion

Note: When you delete a folder, all items in that folder are moved to “Uncategorized” — the items themselves are not deleted.

2. Organizing content into folders

Assigning items to folders

From the list view:

1. Select one or more items using checkboxes
2. Choose Move to Folder from the bulk actions dropdown
3. Select the target folder from the sidebar
4. Items are moved immediately

From the post/media editor:

1. Open any post, page, or media item for editing
2. Find the Folder meta box in the sidebar (Classic Editor) or Folder panel (Block Editor)
3. Select a folder from the dropdown
4. Save or update the item

Drag and drop:

1. In the list view, drag an item from the table
2. Drop it onto a folder in the sidebar
3. The item is moved to that folder

Removing items from folders

To remove an item from a folder and mark it as uncategorized:

1. Select the item(s)
2. Use bulk actions to Move to Folder
3. Select Uncategorized

Or edit the item and set the folder to “Uncategorized” in the editor.

3. Filtering by folder

List view filtering

1. Click on any folder in the sidebar
2. The list view updates to show only items in that folder
3. Click All Folders to clear the filter
4. Click Uncategorized to view items without a folder

Folder counts

Each folder displays the number of items it contains (including nested folders). This count updates automatically as you move items.

4. Post type configuration (Pro)

In the Pro version, you can enable folders for any post type:

1. Open the Folder Manager module settings
2. In the Post Types section, select which post types should have folders
3. Save settings
4. Folders will appear on the list screens for those post types

Note: The free version only supports the Media Library.

Best Practices

• Use descriptive folder names for easy identification
• Nest folders logically to create a hierarchy that matches your content structure (e.g., “Marketing > Blog Posts > 2024”)
• Keep folder structures shallow when possible — too many nested levels can be hard to navigate
• Use the “Uncategorized” filter to find items that haven’t been organized yet
• Assign folders during upload/creation to keep your library organized from the start

Troubleshooting

Folder sidebar not showing

• Ensure the module is enabled
• Verify you’re on a list screen (Posts, Pages, Media Library, etc.)
• Check that the post type is enabled in module settings (Pro version)
• Clear your browser cache and refresh

Items not appearing in folder

• Confirm the item was successfully moved (check for success notification)
• Refresh the page to ensure the filter is applied
• Verify the item’s post status is published/inherit (drafts may not appear in some views)

Drag and drop not working

• Ensure JavaScript is enabled in your browser
• Check browser console for errors
• Try disabling other plugins that might conflict with drag-and-drop functionality
• Clear browser cache

Folder counts incorrect

• Folder counts include items in nested folders
• Some post statuses (like auto-draft) are excluded from counts
• Refresh the page to update counts

Compatibility & Notes

• Works with WordPress Block Editor and Classic Editor
• Supports both grid and list views in Media Library
• Folders are stored as a hierarchical taxonomy (wpext_folder)
• Each item can belong to only one folder at a time
• Folders are post-type specific (Media folders are separate from Post folders)
• Compatible with WordPress multisite
• Folder structure is preserved when exporting/importing content

Developer hooks

Filters

wpextended/folder-manager/is_post_type_enabled — Control whether a post type has folders enabled

add_filter('wpextended/folder-manager/is_post_type_enabled', function($is_enabled, $post_type, $module) {
    // Disable folders for a specific custom post type
    if ($post_type === 'my_custom_type') {
        return false;
    }
    return $is_enabled;
}, 10, 3);

wpextended/folder-manager/available_post_types — Modify the list of available post types in settings

add_filter('wpextended/folder-manager/available_post_types', function($post_types) {
    // Add a custom label for a post type
    $post_types['my_custom_type'] = 'My Custom Content';
    return $post_types;
});

Actions

wpextended/folder-manager/folder_created — Fires when a folder is created

add_action('wpextended/folder-manager/folder_created', function($folder_id, $post_type) {
    // Custom logic after folder creation
    error_log("New folder created: {$folder_id} for {$post_type}");
}, 10, 2);

wpextended/folder-manager/folder_deleted — Fires when a folder is deleted

add_action('wpextended/folder-manager/folder_deleted', function($folder_id, $post_type) {
    // Custom cleanup logic
}, 10, 2);

wpextended/folder-manager/item_moved — Fires when an item is moved to a folder

add_action('wpextended/folder-manager/item_moved', function($post_id, $folder_id, $post_type) {
    // Track folder assignments
}, 10, 3);

REST API Endpoints

The module provides REST API endpoints for folder management:

• GET /wp-json/wpextended/v1/folder-manager/folders — Get folders for a post type
• POST /wp-json/wpextended/v1/folder-manager/folders — Create a new folder
• PUT /wp-json/wpextended/v1/folder-manager/folders/{id} — Rename a folder
• DELETE /wp-json/wpextended/v1/folder-manager/folders/{id} — Delete a folder
• POST /wp-json/wpextended/v1/folder-manager/folders/{id}/move — Move a folder
• POST /wp-json/wpextended/v1/folder-manager/items/move — Bulk move items to a folder

All endpoints require appropriate WordPress permissions and nonce verification.

This module is perfect for:

• Media-heavy sites needing organized asset libraries
• Multi-author blogs with large content archives
• E-commerce sites organizing product images and documents
• Agencies managing client content across multiple projects
• Publishers organizing articles by category, date, or topic
• Any site with more than a few dozen posts or media files