WordPress Core
Unattached media refers to files in the WordPress Media Library that are not linked to any specific post or page as a parent attachment. This is not the same as unused media — an unattached file can still be actively used in content.
Attached vs unattached vs unused
WordPress has two distinct ways a file can be “connected” to content. The first is parent attachment: when you upload a file while editing a post, WordPress sets that post as the file’s parent in wp_posts. The second is content reference: the file’s ID or URL appears in the post’s content, custom fields or block attributes.
Unattached means the file has no parent post. This happens when files are uploaded directly to the Media Library rather than from within the editor. An unattached file can still be referenced in dozens of posts via content references — it is not necessarily unused.
Why the distinction matters
WordPress’s built-in filter “Unattached” in the Media Library shows files with no parent post. This is often misread as “files that can safely be deleted.” It is not. Mediapapa’s usage index scans actual content references — blocks, custom fields, widget areas, theme options — to determine whether a file is genuinely unused, regardless of whether it is attached or unattached.
Frequently asked questions
Is unattached the same as unused?
No. Unattached means the file has no parent post in the database. Unused means the file is not referenced anywhere in your content. Many unattached files are actively used — they were uploaded to the library and inserted into content manually. Mediapapa’s unused media detection is based on actual content scanning, not the attached/unattached status.
Can I bulk-delete unattached media safely?
Only if you have confirmed they are also unused. Deleting all unattached files based on the WordPress filter alone will break any content that references them. Always use a full usage scan before bulk deleting.
Related terms: Unused Media · Attachment · Usage Index · Deletion Warnings
Curious what is hiding in your library?
Scan it for free. No account needed.