organizer

Organizer

Folders for your WordPress media, posts, and pages

Organizer adds folders to WordPress. Create folders for your media library, posts, and pages—then drag and drop items to organize them. No more scrolling through hundreds of images to find what you need.

Getting Started

What you need:

  • WordPress 5.8 or newer
  • PHP 7.4 or newer
  • Admin access to your site

To install:

  1. Download the plugin from your CraftedPath account
  2. In WordPress, go to Plugins → Add New → Upload Plugin
  3. Upload the zip file and click Activate
  4. Go to CraftedPath → License and enter your license key

The plugin creates its database tables automatically and adds a folder sidebar to your media library.

Creating Folders

To create a folder:

  1. Go to Media → Library (or Posts, or Pages)
  2. Look for the folder sidebar on the left
  3. Click the + button
  4. Type a folder name
  5. Press Enter or click Create

Nested folders: You can create folders inside other folders. Right-click a folder and choose "Add Subfolder" or drag a folder onto another to nest it.

Folder colors: Right-click a folder to change its color. Colors help you visually organize—maybe red for urgent, green for approved, blue for client work.

Moving Items

Drag and drop:

  1. Select one or more items in the library
  2. Drag them onto a folder in the sidebar
  3. Release to move them

Using bulk actions:

  1. Select items using checkboxes
  2. Open the Bulk Actions dropdown
  3. Choose "Move to: [Folder Name]"
  4. Click Apply

From the folder column: In list view, you'll see a Folder column. Click the folder name to filter by that folder, or use the dropdown to change an item's folder.

Organizing Media

The media library gets a folder sidebar on the left side of the screen.

Viewing by folder:

  • Click a folder to see only items in that folder
  • Click "All Items" to see everything
  • Click "Uncategorized" to see items not in any folder

The sidebar shows:

  • Folder names with item counts
  • Nested folder structure (expandable)
  • Color indicators
  • Drag handles for reordering

Works in both views: Folders work whether you're using the grid view or list view of the media library.

Media modal too: When inserting media into posts, the folder dropdown appears so you can filter while selecting images.

Organizing Posts and Pages

Organizer isn't just for media—you can organize posts and pages into folders too.

To enable:

  1. Go to CraftedPath → Organizer
  2. Check the boxes for Posts and/or Pages
  3. Save settings

Once enabled, the folder sidebar appears on the Posts and Pages list screens, just like in the media library.

Why organize posts?

  • Group posts by project or client
  • Separate drafts by topic while writing
  • Keep related pages together
  • Organize by team member or department

Note: These folders are for internal organization only—they don't affect your site's public URLs or categories.

Reordering Folders

Drag to reorder: Grab a folder by its drag handle and move it up or down. The new order is saved automatically.

Nesting folders: Drag a folder onto another folder to make it a subfolder. Drag it back to the root level to un-nest it.

Folder order persists: Your folder order is saved in the database, so it stays consistent across sessions and users.

Deleting Folders

To delete a folder:

  1. Right-click the folder
  2. Choose "Delete"
  3. Confirm the deletion

What happens to items inside: When you delete a folder, items inside are moved to the parent folder (or become uncategorized if deleting a root folder). Items are never deleted—only the folder organization.

Deleting nested folders: If you delete a folder with subfolders, the subfolders move up to the parent level.

Settings

Go to CraftedPath → Organizer to configure.

Enable organization for:

Type Description
Media Library Organize images, documents, videos, and other uploads
Posts Organize blog posts and articles
Pages Organize static pages

Each type is independent—you can use folders for media without affecting posts, or vice versa.

Troubleshooting

"Folder sidebar isn't showing"

  • Check that the post type is enabled in CraftedPath → Organizer
  • Make sure you're on the correct admin page (upload.php for media, edit.php for posts/pages)
  • Clear your browser cache—sometimes JavaScript needs a refresh

"Drag and drop isn't working"

  • Make sure JavaScript is enabled
  • Check browser console for errors
  • Try a different browser to rule out extensions
  • Some page builders modify the admin and may conflict

"Item counts are wrong"

  • Counts update after moving items—try refreshing the page
  • Trashed items don't count
  • Items can only be in one folder at a time (per post type)

"Folders disappeared after update"

  • Folders are stored in custom database tables
  • Check that the tables exist: wp_cpo_folders and wp_cpo_folder_items
  • If tables are missing, deactivate and reactivate the plugin

"Can't see folders another user created"

  • Folders are shared across all users—everyone sees the same folder structure
  • Make sure you have the upload_files capability (Editors and Admins have this by default)

Technical Details

Database tables:

  • wp_cpo_folders — stores folder hierarchy (name, parent, color, sort order)
  • wp_cpo_folder_items — maps posts/attachments to folders

How items are organized:

  • Each item can be in one folder per post type
  • Moving to a new folder removes it from the previous one
  • Items without a folder appear in "Uncategorized"

Folder data:

  • name — display name
  • slug — URL-safe identifier
  • parent_id — parent folder (null for root)
  • post_type — which content type (attachment, post, page)
  • color — hex color for visual organization
  • sort_order — custom ordering

Settings stored in: wp_options table, key cpo_settings

To uninstall completely:

  1. Deactivate and delete the plugin
  2. Tables stay in your database by default
  3. To remove everything:
    • Drop wp_cpo_folders and wp_cpo_folder_items tables
    • Delete the cpo_db_version and cpo_settings options