Media Ranger

By Luis Ruiz

0+ active installationsVersion 1.0.3

Import external images into your Media Library and rewrite the URLs in your posts. Preview everything with a dry run first.

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, srcset and <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

  1. Upload the media-ranger folder to /wp-content/plugins/, or install it from the Plugins screen.
  2. Activate the plugin.
  3. Go to Tools → Media Ranger.
  4. Enter the host to import from (or * for all external hosts), keep “Dry run” ticked and click “Scan Only”.
  5. 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 /scan REST 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_from parameter 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.