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.
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, /scan and /count) for users who can manage options. /scan is always a dry run, and only_from is required on /run and /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 http or https scheme, and performs a HEAD request that blocks requests to private/internal network addresses (via wp_safe_remote_head()). It also checks the Content-Type (must be an image) and the Content-Length (default max 20 MB) before downloading. These can be adjusted with the mran_allowed_mime_prefixes and mran_max_download_size filters, and the MRAN_HTTP_TIMEOUT constant (default 10 seconds, define it in wp-config.php).
Screenshots
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.



