Description
Images hotlinked from another site disappear when that site moves, changes its URLs or goes offline. After a migration from Webflow or Squarespace, or years of pasting from CDNs, your posts can depend on dozens of servers you don’t control.
Media Ranger scans your posts, pages and custom post types for images hosted on external domains, downloads them to your Media Library and replaces the URLs in the content with the local files.
Stay in control
- Choose post types, post status and the hosts to import from or exclude (wildcards supported)
- Run a dry run first to see what would change, without modifying anything
- Process in batches to avoid timeouts on large sites
- Download a CSV report of every post and image processed (spreadsheet formulas are neutralised)
Smart detection
- Finds images in
src,data-src,srcsetand<picture>sources - Supports JPEG, PNG, GIF, WebP and AVIF
- Never imports the same image twice: already imported images are reused
- Optionally prefers the original size over thumbnails
Built to be safe
- Rejects non-HTTP(S) URLs and private network addresses
- Checks content type and file size before downloading
- Compatible with WPML and Polylang
Ideal for site migrations, content teams consolidating media from several CDNs, and anyone who wants all images served from their own server.
SUPPORT
Need help or have a suggestion?
Please use the official WordPress.org Support Forum for any issues related to the plugin.
Want to know more?
Keep your images on your own site: the plugin page explains how it works, what it records and what it deliberately leaves out. For anything else, or to get in touch with the development team, visit our official website.
Like the plugin?
Please leave a 5-star review and help others discover Media Ranger.
ABOUT BUBUKU_CODE
We develop custom solutions for WordPress focused on performance, accessibility, and maintainable code. Our work includes plugins, themes, and integrations designed to improve the daily workflow of marketing and content teams.
Privacy Policy
Media Ranger stores no personal data and sends nothing to third parties. When you run an import, your server requests the image files from the hosts you specify. The original URL of each imported image is saved as attachment metadata.
Screenshots



Installation
- Upload the
media-rangerfolder to/wp-content/plugins/, or install it from the Plugins screen. - Activate the plugin.
- Go to Tools Media Ranger.
- Enter the host to import from (or
*for all external hosts), keep «Dry run» ticked and click «Scan Only». - When the results look right, untick «Dry run» and click «Run Import».
FAQ
-
Does this modify my original posts?
-
Only when «Dry run» is off: then the post content is updated to use local URLs. The original images stay untouched on their servers. Back up your database before large imports.
-
What happens if an image fails to download?
-
The plugin logs the error and continues processing other images. Failed downloads are reported in the results.
-
Can I use this with WooCommerce products?
-
Yes! Simply include «product» in the Post Types field to scan WooCommerce products.
-
Does it work with WPML or Polylang?
-
Yes, the plugin is fully compatible with both WPML and Polylang. You can process all languages at once or select a specific language.
-
How do I avoid re-importing the same image?
-
The plugin stores the original source URL as attachment metadata. When scanning, it checks if an image was already imported and reuses the existing attachment.
-
Can I run it programmatically?
-
Yes. The plugin exposes REST endpoints (
/wp-json/media-ranger/v1/run,/scanand/count) for users who can manage options./scanis always a dry run, andonly_fromis required on/runand/scan(use*for all external hosts). -
How does the plugin protect against unsafe downloads?
-
Before downloading any remote image, the plugin rejects URLs that don’t use the
httporhttpsscheme, and performs a HEAD request that blocks requests to private/internal network addresses (viawp_safe_remote_head()). It also checks theContent-Type(must be an image) and theContent-Length(default max 20 MB) before downloading. These can be adjusted with themran_allowed_mime_prefixesandmran_max_download_sizefilters, and theMRAN_HTTP_TIMEOUTconstant (default 10 seconds, define it inwp-config.php).
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Media Ranger” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Media Ranger” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.3
- New admin screen, CSV report download and fully translatable interface.
- Fix: the
/scanREST endpoint is now always a dry run. - Fix: CSV report no longer lets spreadsheets run formulas from post titles.
- Fix: «Posts per batch» is now applied.
- The REST
only_fromparameter is now required (use*for all external hosts).
1.0.2
- Added icons, banners and screenshots.
1.0.1
- Security hardening of remote image downloads.
1.0.0
- Initial release.
