Skip to content
GPLWP Guides

How to organize media files in WordPress

Media & Galleries Time About 20 minutes for a new structure; longer for a large existing library 6 steps Updated 30 Sep 2026

MEDIA & GALLERIES
The short answer

WordPress can organise uploads into year-and-month folders, but it has no built-in descriptive folder system for the Media Library. For a small library, use clear filenames, titles and filters; for large collections or FTP-based folders, use a media-folder plugin.

The route
  1. 01Choose a folder structure
  2. 02Set WordPress date folders
  3. 03Use the library for small collections
  4. 04Handle FTP uploads carefully
  5. 05Use code only for custom routing
  6. 06Use a folder plugin for large libraries

What you need

  • WordPress administrator access
  • A backup before moving existing files
  • FTP or hosting file-manager access if changing physical folders
  • A folder naming plan

Choose a folder structure

Decide whether you need to organise the Media Library view, the actual files on the server, or both. A virtual folder system helps editors find attachments without changing URLs. Physical folders change the files under wp-content/uploads and are more useful when you regularly manage a large library through FTP.

Keep the structure shallow and predictable, such as products, case-studies and team. Avoid folders based on one-off campaigns that will be difficult to maintain later.

Set WordPress date folders

Open Settings → Media and decide whether to enable Organize my uploads into month- and year-based folders. When enabled, WordPress places new uploads in paths such as wp-content/uploads/2026/09; the folders are created during upload if the uploads directory is writable.

This is the built-in option, but it is only date-based. Changing the setting controls how future uploads are stored; it does not give you descriptive folders in the Media Library or automatically sort your existing files into a new structure.

Use the library for small collections

For a modest library, upload files through Media → Add New, then give each item a useful filename, title, caption, alternative text and description. WordPress lets you search and filter the Media Library, so consistent names and metadata are often enough without adding a folder plugin.

Use names such as blue-widget-front.jpg rather than IMG_4832.jpg. Do not rely on folders alone: editors and templates still find media by attachment records, filenames, metadata and URLs.

Handle FTP uploads carefully

You can create folders and upload files through FTP or your host’s file manager, but copying a file into wp-content/uploads does not by itself create a WordPress attachment record. The file may work at its direct URL while remaining absent from the Media Library, unavailable as a featured image and missing generated image metadata.

For files already uploaded by FTP, use an importer or media-management tool to register them with WordPress. Do not move files that are already used on the site unless you also update references or provide redirects. This is where a Friday change commonly produces broken images in posts, products, emails and feeds.

Use code only for custom routing

If you have a developer, WordPress can route new uploads to a custom directory by filtering upload_dir. The upload process also exposes wp_handle_upload_prefilter, which can inspect or change a filename before the file is moved.

This is suitable for a controlled rule such as sending uploads to a fixed client or document folder. It is not a complete media-folder system: you still need a reliable rule for existing attachments, image sizes, permissions, migrations, URL changes and rollback. Test it on staging before applying it to a live library.

Use a folder plugin for large libraries

If you need descriptive folders in the Media Library, bulk organisation, FTP-friendly paths or safer movement of existing files, use a plugin designed for that job. WordPress Real Physical Media physically organises uploads into folders based on a Real Media Library structure, can reorganise existing files, and supports images, video, audio, documents and PDFs.

Its redirects are particularly important when a move or rename changes a file URL. Back up the database and uploads directory first, move a small batch, then check image URLs, PDFs, featured images and attachment pages before processing the rest. Its queue and optional background processing are useful for large libraries.

The fast route

Let WordPress Real Physical Media do it

Physically organizes uploads into descriptive folders with redirects, ideal for large libraries managed through FTP.

Get WordPress Real Physical Media

Sources

  1. wordpress.org /documentation/article/settings-media-screen/?utm_source=ope…
  2. wordpress.org /documentation/article/media-library-screen/?utm_source=open…
  3. developer.wordpress.org /reference/hooks/wp_handle_upload_prefilter/?utm_source=open…

Questions

Does WordPress have media folders built in?
No. WordPress has a Media Library with search and filtering, plus an option to store uploads in year-and-month folders, but it does not provide descriptive folders for organising attachments. The date-folder setting is found under Settings → Media and applies to the upload path used during uploads.
Can I organise WordPress media files with FTP?
Yes, you can create folders and copy files into the uploads directory with FTP, but WordPress will not automatically register those files as Media Library attachments. They may be reachable by URL while missing from the library, featured-image picker and generated metadata. Use an importer or media-management tool if the files must behave like normal WordPress media.
Will moving media files break image links?
It can. Moving or renaming a file changes its URL, so hard-coded image, document and video references can return 404 errors unless the old URL redirects or the references are updated. Back up first, test a small batch, and check posts, products, featured images, emails and feeds after any physical move.
Should I use virtual or physical media folders?
Use virtual folders when you mainly need a cleaner Media Library and want existing URLs to stay unchanged. Use physical folders when FTP access, descriptive server paths or large-library file management matter. Physical moves need more care because they can change URLs, affect generated files and require redirects or reference updates.
What is the fastest way to organise a large media library?
Install a media-folder plugin, create a small folder structure, back up the site, and move a test batch before processing everything. WordPress Real Physical Media is suited to libraries that need physical folders, FTP management and redirects when files move. Keep the date-based structure if it already works and you only need better searching.