This plugin helps you find usage of attachments, posts, links, blocks and more in all post types, taxonomy terms, post meta, user meta, and menus. This plugin is multisite compatible!

Items That Will Be Detected

  • images, attachments
  • links
  • Gutenberg custom blocks or reusable blocks
  • iframes
  • Shortcodes (coming soon)

Areas Where It Searches For The Items

  • posts, post meta (even custom post types)
  • taxonomy terms, term meta
  • users, user meta
  • WordPress menus
  • Redirection rules (if Redirection plugin is installed)

Discover Problems

  • Broken links ( 404 errors hurt SEO ranking)
  • Redirects referenced (301, 302 etc.)
  • Unused reusable blocks

Prevent You From Causing Problems

  • Know where something is referenced before you delete it and create broken links or broken functionality on your site
  • Find where a reusable block is used before you delete the reusable block
  • Find out where blocks are used before you uninstall a plugin that has custom blocks
  • Know when the slug of your page has been accidentally redirected due to regex matching


  • Does not search theme’s code or any plugin’s code for hardcoded references
  • Does not detect references or backlinks located on websites beyond the scope of this WordPress install.
  • Does not search custom database tables
  • WARNING: Does not find every existence of usage due to mentioned lines above and possibly some unforeseen scenarios. Please always be cautious when deleting posts and attachments. This plugin does it’s best to help you be more confident in deleting unused content and managing existing content.

Compatible With Plugins

Quick Setup Guides

Single Site Setup

  1. Install the WhereUsed plugin per instructions above and then activate it.
  2. Modify settings as need to ensure your entire site gets scanned properly. Adjust settings here: Admin > Tools > WhereUsed > Settings
  3. Do an initial full scan on the bottom right of the Dashboard here: Admin > Tools > WhereUsed
  4. Once the scan is complete, you can review the Dashboard to discover detected broken links and redirects.

Multisite Setup

  1. Install the WhereUsed plugin per the instructions above and activate the plugin for the entire network or go to each site individually in the network and activate the plugin.
  2. All sites will default to using the network settings (for convenience). This can be disabled on a per site basis in the network settings area. WP Admin > Network Settings > Settings > WhereUsed
  3. Each site will need to be scanned so that all references are detected
  4. Multiple scans (full scan on each site) are prevented from running simultaneously to protect the server from getting too overwhelmed at one time.
  5. Once all scans have been run, you will be able to see all references on each site and all references between each site.



  1. Navigate to the Plugin management area:

    • Single Site: WP Admin > Plugins
    • Multisite: WP Admin > Network Admin > Plugins
  2. Click “Add New” button at the top of the Plugins page. A new page will load displaying an Upload button at the top and an area to search for plugins.

  3. You can either manually upload a zip file of WhereUsed, or you can search for the plugin in the WordPress repository by searching for “WhereUsed”.
  4. Once you have installed the plugin, continue to the Quick Setup Guides below:


There are no reviews for this plugin.

Contributors & Developers

“WhereUsed” is open source software. The following people have contributed to this plugin.


Translate “WhereUsed” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.


Versions Key (Major.Minor.Patch)

  • Major — 1.x.x increase involves major changes to the visual or functional aspects of the plugin. (higher risk of breaking changes)
  • Minor — x.1.x increase introduces new features or improvements to existing features. (low risk of breaking changes)
  • Patch — x.x.1 increase is a bug, security fix, or minor improvement and does not introduce new features. (non-breaking changes)

Version 1.0.6

Release Date — 02 Sept 2022
* Bug Fix: Status scan was running out of memory
* Bug Fix: Any notifications beyond 621 count cannot be marked as read
* Minor Improvement: Added Notification to the user if a scan halted due to running out of memory

Version 1.0.5

Release Date — 1 Sept 2022
* Bug Fix: Status check cron is running multiple times instead of once when scheduled due to caching
* Bug Fix: Status code scan scheduled cron shows all options in setting by default when saved as “No”
* Minor Improvement: Updated link to GPL license

Version 1.0.4

Release Date — 1 Sept 2022
* Bug Fix: Removed double slashes in logo src as well as JS src
* Bug Fix: The taxonomy terms were not being rescanned after a term was updated
* Bug Fix: The taxonomy terms references were not getting removed from the scan index db table when the term was deleted
* Bug Fix: The user was not rescanned after the user profile was updated
* Bug Fix: The user references were not getting removed from the scan index db table when the user was deleted

Version 1.0.3

Release Date — 15 Jul 2022
* Bug Fix: In a multisite setup using Network Media Library plugin, attachments references detected as a featured image are missing title and additional information.
* Bug Fix: Turned off SSL verify when getting status codes for links so that it works on local environment URLs when snakeoil wildcard self-signed SSLs are used
* Bug Fix: Network settings were getting created in a single site environment
* Bug Fix: User could change scan settings during a running scan and cause the scan to lock up.
* Bug Fix: In a multisite setup, the user could not easily navigate to the network settings from the local site settings
* Security: Fixed an unescaped URL to prevent highly unlikely XSS

Version 1.0.2

Release Date — 13 Jul 2022

  • Improvement: Converted CURL requests to use WP http-api
  • Improvement: Updated ChartJS to version 3.8
  • Minor Improvement: Updated plugin description that is visible in the plugin management area
  • Bug Fix: The “References To This” link in the row actions in the table was incorrect.
  • Security: Implemented some xss escaping

Version 1.0.1

Release Date — 12 Jul 2022

  • Improvement: Added links to the settings and dashboard on the plugins management pages
  • Minor Improvement: Updated license to GPLv3
  • Minor Improvement: Increased minimum WordPress version to 5.1

Version 1.0.0

Release Date — 12 Jul 2022

  • Initial Release