What Are Unattached Images in WordPress?
Have you spotted images marked “Unattached” in your WordPress media library and wondered what that means? It sounds like something is broken — but it usually isn’t. In this guide, we’ll explain what unattached images in WordPress are, how to find them, and what to do about them.
We see this question a lot when helping site owners tidy up media libraries that have grown for years. The confusing part is that “unattached” doesn’t mean “unused” — and mixing those two up is how images end up broken on live pages.
What Are Unattached Images in WordPress?
Every image you upload to WordPress is stored in the Media Library. When you upload an image while editing a page or post, WordPress “attaches” it to that page or post — it records where the image was first uploaded.
An unattached image is simply one that was never uploaded through a specific page or post. That happens when you upload files directly in Media » Library, or when the page an image was attached to gets deleted. The image file itself is perfectly fine either way.
Note: Attachment only records where an image was uploaded — not where it’s used. An image can appear on ten pages and still show as unattached, and an attached image can be used nowhere at all.
How to Find Unattached Images in Your Media Library
To see what’s attached and what isn’t, go to Media » Library and switch to the list view. The Uploaded to column shows which page or post each image is attached to.
Images that aren’t attached to any page or post display “(Unattached)” in that same column.
To see only the unattached ones, use the filter dropdown at the top of the library and choose Unattached. WordPress will hide everything else, which makes a big library much easier to review.
If you’re not sure where your uploads actually live on the server, see our guide on where WordPress uploads images to.
Should You Delete Unattached Images?
Be careful here. It’s tempting to filter to Unattached and bulk-delete everything to free up space — but unattached images are often still in use.
Here are the most common cases where an “unattached” image is doing real work on your site:
- It was uploaded straight to the Media Library, then inserted into one or more posts later
- It’s used in a slider, gallery, widget, or theme setting rather than a regular post
- Its original post was deleted, but the image was also placed on other pages that still exist
Deleting an image that’s still in use leaves a broken image wherever it appeared, so we’d suggest treating the Unattached filter as a starting point for review, not a delete list.
Warning: Deleting a media file removes it from your server permanently — there’s no trash for media by default. Back up your site before cleaning out unattached images.
When you do clean up, work in small batches: preview the image, check whether the file name appears anywhere on your site, and only then delete. Keeping your library lean also helps your pages load faster — smaller, well-managed media is one of the easiest speed wins. Our guide on saving images for the web shows how to keep new uploads lean from the start.
FAQs About Unattached Images in WordPress
What does unattached mean in the WordPress Media Library?
Unattached means the image wasn’t uploaded through a specific page or post, so WordPress has no upload location on record for it. It says nothing about whether the image is actually used on your site.
Is it safe to delete unattached images in WordPress?
Not automatically. Unattached images can still be used in posts, sliders, galleries, and theme settings, and deleting one that’s in use leaves a broken image on your site. Review each image first and back up your site before deleting anything.
How do I attach an unattached image to a post?
In the Media Library list view, hover over the image and click the Attach link, then search for the page or post you want. This only changes the recorded upload location — it doesn’t insert the image into the content.
Do unattached images slow down a WordPress site?
Not directly — images only affect load time on pages where they appear. Unused files do take up storage space and make backups larger, so an occasional cleanup is still worth it.
That’s it! We hope this guide helped you understand unattached images in WordPress and clean up your media library safely. If you’d like to keep learning, check out these beginner-friendly guides:
- How to Create an Image Slider in WordPress
- How to Wrap Text Around Images in WordPress
- How to Fix the Image Size For Your Slider in WordPress
- How to Add an Image Slider with Captions in WordPress
Related Posts
Harold
It appears that Featured Images used in the blog roll (index.php) as a thumbnail are also marked as unattached. Is this correct or is this a theme error?
Barbi Atkinson
Hi Harold 🙂 An image in WordPress only becomes “attached” if the image is uploaded to the post. If you upload images into the Media Library and then select that featured image that’s already uploaded, WordPress doesn’t count this as an “attached” image.
David
“Images that are not used in any of the WordPress page or post will display as unattached in this option.”
This does not seem to be the case at all. I see numerous images that say ‘detached’, yet I go to the webpages that they are on, and yep, the images are definitely there… am I missing something in your explanation?
Leonel
Yes, he don’t know what he’s talking about. You can have all your images being used in your site and still being marked as “unattached “.
Paul Riddle
If I delete the hypertext link in a page does the PDF linked to it become in attached? If not how can I find orphan PDF files which are not referenced anymore on the site?
Thanks.
Ready to start creating slides the easy way?
Get Soliloquy NowCookie Consent