A WordPress media library with lots of images becomes difficult to manage if you rely only on thumbnails and upload dates. One photograph can have several generated versions, while a file labelled “Unattached” may still appear on your website. To tidy things up without removing useful material, treat organisation and deletion as separate tasks, and check how each file is used before making changes.
1. Organise your media library so files are easy to find
The standard WordPress media library does not work like a folder system where you move documents around. It displays records for uploaded files, together with metadata such as their title, type and upload date. Physical organisation into year and month directories, when enabled, is not a substitute for an editorial classification system.
Start with a straightforward naming convention for new uploads. Use descriptive filenames, such as “pottery-workshop-interior.jpg”, rather than names generated by a camera. A clear filename helps you find and identify a file, but it does not replace the other information associated with an image.
- Title: choose a recognisable name for the people managing your website.
- Alternative text: describe the relevant information conveyed by the image in its context; do not turn it into a list of keywords.
- Caption: add one when an image needs a visible explanation alongside it.
- Description: use it for editorial context or useful background information about the asset.
For large collections, a plugin offering categories or virtual folders may help. Check whether it simply groups media records or also changes files and their URLs. Avoid manually renaming or moving files that have already been published, as existing links may stop working.
2. Understand originals and generated image versions
When you upload an image, WordPress may generate several sizes for display. Your theme and plugins can register additional sizes too. A single library entry can therefore represent several stored files, rather than just one physical image.
What “original” means here
The file you initially upload is the source. For certain large images, WordPress may create a scaled version that becomes the attachment’s main image while retaining the initial source file. As a result, the image described as full size is not always identical to the file you uploaded.
Smaller versions may appear in article listings, galleries, product pages or layouts adapted to different devices. A browser may receive several image options and select a suitable version, depending on the page configuration and the screen.
Do not delete a file simply because its name contains dimensions or it looks like a copy. It may be a version that your website actively uses. Optimisation plugins can also create alternative formats, and some services keep media in external storage. The number of files in storage should not be confused with the number of entries in your media library.
3. Why “Unattached” does not mean “unused”
The “Unattached” label indicates that a media record has no parent association with a WordPress content item. It is not a comprehensive check of everywhere the file appears. An image uploaded directly to the library and later inserted into a page may remain unattached.
A file can be used without that association in many places:
- as a logo, background image, or part of a header or footer;
- inside a page builder, template or reusable block;
- in custom fields, galleries or plugin settings;
- through a URL entered manually in HTML or theme code;
- in a newsletter, document or external website that links to its address.
The reverse is possible too: a file attached to a post may no longer appear in the current content. The filter for unattached files is therefore a starting point for investigation, not a list of assets that are safe to delete.
4. Check usage before cleaning up media
Begin with an inventory of potential candidates rather than selecting every result. Record each file’s URL, its media ID where available, its name and the reason you think it is no longer needed. Keep suspected duplicates, test uploads and images from completed campaigns in separate groups.
- Search your content. Check posts, pages and relevant content types, including drafts and scheduled items. Search for the filename or URL as well as the media ID, where your tools allow.
- Inspect site-wide elements. Review your logo, image-based navigation, header, footer, templates and theme settings.
- Check plugins. Look through galleries, products, custom fields and your page builder, if you use them.
- Review representative pages. Include the homepage, archive pages and important landing pages on both larger screens and mobile devices.
- Consider external uses. Ask your team whether file URLs appear in campaigns, documents or other projects.
A media-cleaning tool can find references and suggest candidates, but its results depend on compatibility with your theme and installed plugins. Dynamic references, URLs stored in code and some serialised data may need additional checks. A search that finds nothing does not prove that a file is unused.
5. Delete in small batches and prepare for recovery
Before deleting anything, create or verify a backup covering both your database and media files. Confirm where the copy is stored and how restoration works. If you have a test environment, use it to assess the procedure, bearing in mind that it may not reproduce every integration on your live website.
Permanently deleting a media entry can remove its associated file and the generated versions managed by WordPress. Do not assume that media items automatically have a trash facility, or that every plugin provides an undo option. Read how your chosen tool handles deletion before confirming the operation.
- Start with a small batch of files checked individually.
- Keep a record of the URLs and assets you remove.
- Review the relevant pages for missing images.
- Check caching and image delivery services: a cached copy may temporarily hide a missing file.
- Continue only after assessing the first batch.
Avoid manually deleting generated versions from storage as a quick way to reduce disk usage. You could leave metadata and references pointing to files that no longer exist. If you want to remove obsolete image sizes, review the configuration and regeneration of required versions as a separate task.
6. Maintain order with a straightforward routine
Careful media management starts before uploading: check whether an asset already exists, prepare appropriate dimensions and complete the useful information. Assign responsibility for the library and periodically review temporary material. Avoid automatic deletion based solely on age or the “Unattached” label.
If you are reviewing your website’s infrastructure, you can explore WordPress hosting and the information in the FAQ. For questions about your project’s requirements, use the contact page. Organising files and checking their usage remain separate tasks from choosing hosting.
The practical rule: organise first, check references, prepare for recovery and only then delete in small batches. In the media library, a missing association is not evidence that a file has no remaining use.
