How to Find Where an Image Is Used in WordPress

You are about to replace a logo, tidy up the library, or delete an old photo, and one question comes first: where is this image actually used? WordPress does not answer it. Here is why, how to find out by hand, and how to get the answer in one click.

The short answer

• By hand: search your content for the file name, then check featured images, page builders and custom fields. For developers, search the database.
• Faster: use a tool that keeps an index of every reference. In CICO Media Pro, every image card shows whether it is used and a Where used panel lists each place.
• Either way: treat “not found” as “not found yet”, never as a guarantee that an image is safe to delete.

Why WordPress does not tell you

When you upload an image from inside a post or page, WordPress records that post as the image’s parent. That is all the Uploaded to column shows. It is a single post, and only the one that was open at upload time.

After that, an image can be used in many other places: other posts, featured images, page builder layouts, custom fields, widgets, theme settings. These references are stored in different ways, as block markup, as an ID in a custom field, as a URL in a builder layout. WordPress does not keep an index that joins them all together.

Method 1: check the Uploaded to column

Open Media > Library, switch to the list view and look at the Uploaded to column. It names one parent post, or shows “Unattached”. Use it as a hint, not as proof: an image can be attached to one post and used on ten others, or show as unattached while it is used in a builder layout.

Method 2: search your content for the file name

The search box in Posts and Pages looks inside the content. Search for the file name without the extension and without the size suffix: WordPress creates resized copies named like photo-300x200.jpg, so searching photo catches all of them.

In content created with the block editor or the classic editor, images also carry a class with their ID, such as wp-image-123. Searching for that class finds the posts that contain that exact image.

This method does not look into builder layouts, custom fields or widgets.

Method 3: check featured images, builders and custom fields

• Featured images are not part of the content. Check the post’s featured image box, or filter your posts by the image you are looking for.
• Page builders such as Elementor store layouts as structured data, so a content search does not see them. You need to open the page in the builder and look.
• Custom fields (for example ACF image fields) store the image ID. Check the field groups that contain image or gallery fields.

Method 4: search the database

If you are comfortable with a database tool, a read-only query shows where a file name or ID appears. Take a backup first, replace wp_ with your table prefix, and change photo to your file name.

-- Posts and pages whose content mentions the file
SELECT ID, post_title, post_type, post_status
FROM wp_posts
WHERE post_content LIKE '%photo%';

-- Custom fields and builder data that mention the file or the image ID
SELECT post_id, meta_key
FROM wp_postmeta
WHERE meta_value LIKE '%photo%' OR meta_value = '123';

The second query also finds featured images (_thumbnail_id) and most builder and custom field data. It still cannot see references that live in code, in widgets stored in options, or in theme settings.

How CICO Media Pro finds where an image is used

CICO Media Pro builds a persistent usage index in the background and keeps it up to date, so the answer is ready when you open the library.

1. Install both plugins. Install the free CICO Media plugin, then CICO Media Pro, and activate your license. Pro requires the free plugin.
2. Let the index build. Indexing runs in the background and adapts to your server. It does not change your content or your files.
3. Read the result on every card. Each image shows Used · N or No usage found. Open the Where used panel to see every place: the post or page, the source (Gutenberg, Elementor, ACF, WooCommerce or WPBakery), whether it is Live, Not live or Unknown, and a link to edit it.

You can also filter the library by usage, so you can list the images with no usage found in a few clicks.

In the docs: step by step in Usage Intelligence, and what each source covers in Integrations.

What to keep in mind

• Used means a reference was found. It does not always mean the image is visible to a visitor. Pro separates the reference from its frontend status: Live, Not live or Unknown. We wrote more about this in Used vs Visible.
• Unknown is an honest answer. When CICO cannot verify visibility with enough confidence, it says Unknown instead of guessing.
• No tool detects 100% of usage. Custom code and unusual themes can hold references that no plugin can see. Check before you delete.
• CICO never deletes for you. It gives you better information. The decision, and the deletion, stay yours. If you are cleaning up unattached images, read Unattached vs Unused Media in WordPress first.