Where used? 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
- Gutenberg custom blocks or reusable blocks
- 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)
- 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 via Redirection plugin
IMPORTANT: This Plugin DOES NOT
- 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 your 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 maintaining existing content.
- Multisite Installations
- Fix Alt Text
- Advanced Custom Fields – ACF
- Network Media Library
Recommended Plugins To Install
- Redirection – WhereUsed is more powerful as a tool with the Redirection plugin. Certain features of WhereUsed are not available unless Redirection is installed.
- Fix Alt Text – Like WhereUsed? You’ll love our other plugin, Fix Alt Text, which will help you manage your image alt text easier for better website SEO and accessibility.
Quick Setup Guides
Single Site Setup
- Install the WhereUsed plugin per instructions above and then activate it.
- Modify settings as need to ensure your entire site gets scanned properly. Adjust settings here: Admin > Tools > WhereUsed > Settings
- Do an initial full scan on the bottom right of the Dashboard here: Admin > Tools > WhereUsed
- Once the scan is complete, you can review the Dashboard to discover detected broken links and redirects.
- 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.
- 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
- Each site will need to be scanned so that all references are detected
- Multiple scans (full scan on each site) are prevented from running simultaneously to protect the server from getting too overwhelmed at one time.
- Once all scans have been run, you will be able to see all references on each site and all references between each site.
Navigate to the Plugin management area:
- Single Site: WP Admin > Plugins
- Multisite: WP Admin > Network Admin > Plugins
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.
- 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”.
- Once you have installed the plugin, continue to the Quick Setup Guides below:
Contributors & Developers
“WhereUsed” is open source software. The following people have contributed to this plugin.Contributors
Versions Key (Major.Minor.Patch)
- Major – 1.x.x increase involves major changes to the visual or functional aspects of the plugin, or removing functionality that has been previously deprecated. (higher risk of breaking changes)
- Minor – x.1.x increase introduces new features, improvements to existing features, or introduces deprecations. (low risk of breaking changes)
- Patch – x.x.1 increase is a bug fix, security fix, or minor improvement and does not introduce new features. (non-breaking changes)
Release Date – 29 Nov 2022
* Bug Fix: Scan duration details should not display 0 days, 0 hours, etc.
* Bug Fix: Scan stats “Total Posts Scanned” should say “Total Unique URLs Checked” for a check status scan
* Bug Fix: Scan is showing a message that a scan is needed when it is actually not
* Bug Fix: When cancelling a status-check, the action was marking a full scan as needed
* Bug Fix: Relative anchor URLs starting with a # were getting assigned the incorrect base URL
* Minor Improvement: Tested up to: 6.1.1
Release Date – 09 Nov 2022
* Bug Fix: Migration script wasn’t single site compatible
* Bug Fix: Content that required authentication could not be scanned on single site installs. Worked on multisite.
* Bug Fix: When scan menus option changed in settings, the user was not being notified that a new scan was needed.
* Bug Fix: Some changes to network settings in a multisite were not notifying sites that they needed a new scan.
* Bug Fix: Headers sent prematurely when displaying admin notice if updating plugin while another plugin is using an older version of Helpers Library
* Bug Fix: Scans involving thousands of users, posts, or terms would run out of memory due to $wpdb caching
* Bug Fix: There was a rare possibility that a post gets queued and then the post is deleted before the background scan processes it, which could cause the progress bar to stall on the dashboard.
* Bug Fix: When a post was deleted, posts referencing that now deleted post were not getting rescanned.
* Bug Fix: Checking if the Redirection plugin was active and caching it was resulting in an incorrect value when switching blogs in multisite setup
* Bug Fix: Non URLs were not being removed from queue during status check cron, which would hang the scan
* Bug Fix: User could access unused attachment data when a full scan had not completed, giving incorrect information
* Bug Fix: User and WP Cron could start a status check even though a full scan had not completed
* Minor Improvement: Added warning message at the top of the Unused Attachments Table
* Minor Improvement: Updated Helpers Library dependency
* Minor Improvement: removed unused notify network sites setting and logic associated with it. In a multisite setup, all sites with the plugin active will get notified
* Minor Improvement: Tested up to: 6.1.0
Release Date – 27 Oct 2022
* Bug Fix: Scans could not access pages that required user to be logged in to view
* Security: Removed usernames from the scan users queue file
Release Date – 26 Oct 2022
* New Feature: Filter “whereused_excluded_post_types” has been added to allow modification of post types excluded from scans
* New Feature: Filter “whereused_excluded_taxonomies” has been added to allow modification of post types excluded from scans
* Improvement: Debug logging is more efficient
* Improvement: Scan was revised to now handle very large databases and use less resources
* Improvement: Updated recommended taxonomies and post types to scan. Please review your settings.
* Bug Fix: The plugin was initializing on the init hook, but activation hooks do not work on the init hook and were causing loading issues when plugin was activated.
* Bug Fix: Uninstall script fixed
* Bug Fix: Scan would run out of memory when trying to queue 400K posts
* Bug Fix: Post was not getting rescanned after it has been updated
* Security: Minor XSS Escaping within a user protected area
Release Date – 20 Oct 2022
* Minor Improvement: Load debug logging sooner
* Bug Fix: Migration was not running to update the DB for better performance.
* Bug Fix: Referencing some incorrect constant variables
Release Date – 18 Oct 2022
* Bug Fix: Could not start a new scan if a previous scan was interrupted by deactivating the plugin or some other unexpected action.
Release Date – 18 Oct 2022
* Bug Fix: Uninstalling WhereUsed caused an error.
* Bug Fix: Migration script failed.
* Bug Fix: Fix error due to calling undefined class Admin
* Bug Fix: Fix error related to scope when calling Menu class
Release Date – 18 Oct 2022
* New Feature: Debug area for troubleshooting scan issues. Debug mode must be turned on in settings before it will appear.
* New Feature: Added hook whereused_scan_meta to allow 3rd-party code to associate a custom field that contain a post ID to a post
* New Feature: Added hook whereused_scan_block to allow 3rd-party code to handle the scanning of a custom block
* New Feature: Filter “whereused_ignored_blocks” has been added to replace “WhereUsed/ignored_blocks”
* Improvement: DB tuned for better performance at scale
* Improvement: Updated Helpers_Library 1.1.0 dependency
* Improvement: Refactored admin template header and footer display logic
* Improvement: Updated logic in how we store scan history
* Improvement: Updated the scan progress bar to show what is being scanned and simplified status
* Minor Improvement: Added links to documentation on the dashboard
* Minor Improvement: Added links to documentation throughout the code
* Minor Improvement: Tested up to: 6.0.3
* Bug Fix: Admin notices were not displayed on an AJAX request.
* Bug Fix: Status Check was failing to fully run.
* Bug Fix: The Network Settings tab was not visible on the Settings page when accessed via AJAX and the tab was always visible if the settings page was access directly first
* Bug Fix: wp-admin references were hardcoded throughout the plugin making it incompatible with Bedrock
* Bug Fix: Redirection column was not visible when the plugin Redirection was not installed even though 301s were detected and needed to show destination.
* Deprecated: Filter “WhereUsed/detected_block”
* Deprecated: Filter “WhereUsed/ignored_blocks”
* Note: Increased Minimum WP Version to 5.3
Release Date – 02 Sept 2022
* Minor Improvement: Added Notification to the user if a scan halted due to running out of memory
* Bug Fix: Status scan was running out of memory
* Bug Fix: Any notifications beyond 621 count cannot be marked as read
Release Date – 1 Sept 2022
* Minor Improvement: Updated link to GPL license
* 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”
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
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
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
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
Release Date – 12 Jul 2022
* Initial Release