Title: Linko Media Path Mapper &amp; Swapper
Author: ajiajish
Published: <strong>July 15, 2026</strong>
Last modified: July 15, 2026

---

Search plugins

![](https://ps.w.org/linko-media-path-mapper-and-swapper/assets/banner-772x250.png?
rev=3608997)

![](https://ps.w.org/linko-media-path-mapper-and-swapper/assets/icon-256x256.png?
rev=3608997)

# Linko Media Path Mapper & Swapper

 By [ajiajish](https://profiles.wordpress.org/ajiajish/)

[Download](https://downloads.wordpress.org/plugin/linko-media-path-mapper-and-swapper.1.0.0.zip)

 * [Details](https://wordpress.org/plugins/linko-media-path-mapper-and-swapper/#description)
 * [Reviews](https://wordpress.org/plugins/linko-media-path-mapper-and-swapper/#reviews)
 *  [Installation](https://wordpress.org/plugins/linko-media-path-mapper-and-swapper/#installation)
 * [Development](https://wordpress.org/plugins/linko-media-path-mapper-and-swapper/#developers)

 [Support](https://wordpress.org/support/plugin/linko-media-path-mapper-and-swapper/)

## Description

Are you tired of ugly, date-based WordPress upload URLs like `/wp-content/uploads/
2024/05/image.png`?

**Linko Media Path Mapper & Swapper** is a powerful URL management suite that gives
you complete control over how your media files are served. It is built around 3 
core workflows designed for performance, SEO, and ease of use.

### 🎯 1. Clean & Custom Media Paths

Transform messy upload URLs into beautiful, human-readable paths.
 * Change `/wp-
content/uploads/2024/05/report.pdf`  `/downloads/annual-report.pdf` * Optionally
hide or show file extensions (e.g., `/images/logo` instead of `/images/logo.png`).***
Smart WebP Mapping:** Automatically maps and serves `.webp` versions for modern 
browsers without altering your database. * **Deep Integration:** Works flawlessly
with standard WordPress galleries, ACF (Advanced Custom Fields), and page builders
via our dual-layer filtering system.

### 🔄 2. Smart Media Replacement

Need to update an image or PDF but don’t want to change the URL or lose SEO rankings?
*
Replace the actual file on the server directly from the admin panel. * **Keep or
Update Dates:** Choose to keep the original upload date (for SEO) or update it to
the current date (to move it to a new month folder). * **Rename on the Fly:** Optionally
use the newly uploaded file’s name while automatically updating all custom path 
mappings. * Bypasses CDN and cache issues seamlessly with built-in cache-busting.

### 🔀 3. Advanced Redirection Rules (301, 302, 404)

A lightweight, high-performance redirect manager built right into the plugin.
 ***
Multi-Domain Support:** Easily redirect traffic from an old domain (e.g., `https://
olddomain.com/blog-post`) to your new site paths. * **Flexible Rules:** Set up 301(
Permanent), 302 (Temporary), or 404 (Not Found) responses. * **Hit Tracking:** See
how many times a redirect rule has been triggered directly in the admin UI. * **
Zero Conflict:** Uses smart memory caching to handle thousands of rules without 
slowing down your website.

### 🔧 How It Works (Under the Hood)

Unlike basic redirect plugins, Linko Media Path Mapper & Swapper uses a safe “Dual-
Layer” architecture:
 * **Layer 1:** Intercepts URLs at the PHP data level (before
HTML is generated) for zero performance overhead. * **Layer 2:** Uses a highly optimized
output buffer with regex extraction to catch hardcoded theme URLs (like WebP `<picture
>` tags) without causing memory exhaustion.

## Installation

 1. Upload the `linko-media-path-mapper-and-swapper` folder to the `/wp-content/plugins/`
    directory, or install it directly through the WordPress plugins screen.
 2. Activate the plugin through the ‘Plugins’ menu in WordPress.
 3. Navigate to **Linko Media Path Mapper & Swapper** in your admin sidebar to start
    creating custom paths.
 4. Go to **Redirect Rules** to manage your 301/302 redirects.

## FAQ

### Will this break my existing images if I deactivate the plugin?

No. The plugin does not physically move your files or change WordPress core data.
If you deactivate it, your site will simply revert to the default `/wp-content/uploads/...`
URLs.

### Does it work with page builders like Elementor or Divi?

Yes. The plugin hooks deep into WordPress core filters (`wp_get_attachment_url`,`
the_content`, etc.) and has specific compatibility built-in for ACF image and file
fields.

### What happens if I replace a file using the Media Replacer?

The plugin safely overwrites the physical file on the server. Your custom URL remains
exactly the same, so you don’t lose any SEO value or social media shares.

### Can I redirect an entire old domain to my new WordPress paths?

Yes! In the Redirect Rules tab, simply paste the full old URL (e.g., `https://olddomain.
com/about-us`) as the source, and your new path (e.g., `/about`) as the target.

### Does this work with caching plugins like WP Rocket?

Yes. The plugin automatically clears its own internal URL mapping cache whenever
a file is replaced or a path is updated. For hard caches, a simple “Purge All” in
your caching plugin will reflect the new URLs.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Linko Media Path Mapper & Swapper” is open source software. The following people
have contributed to this plugin.

Contributors

 *   [ ajiajish ](https://profiles.wordpress.org/ajiajish/)

[Translate “Linko Media Path Mapper & Swapper” into your language.](https://translate.wordpress.org/projects/wp-plugins/linko-media-path-mapper-and-swapper)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/linko-media-path-mapper-and-swapper/),
check out the [SVN repository](https://plugins.svn.wordpress.org/linko-media-path-mapper-and-swapper/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/linko-media-path-mapper-and-swapper/)
by [RSS](https://plugins.trac.wordpress.org/log/linko-media-path-mapper-and-swapper/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.0

 * Initial release.
 * Core Feature: Custom media path mapping with extension control.
 * Core Feature: Smart WebP companion auto-mapping.
 * Core Feature: Advanced media file replacement (keep date, rename, change date).
 * Core Feature: Redirect Rules manager (301, 302, 404) with multi-domain support.
 * Performance: Dual-layer URL replacement to prevent memory leaks.
 * Security: Full XSS, SQL Injection, and CSRF protection.

## Meta

 *  Version **1.0.0**
 *  Last updated **13 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.5 or higher **
 *  Tested up to **7.0.1**
 *  PHP version ** 8.0 or higher **
 * Tags
 * [media](https://wordpress.org/plugins/tags/media/)[media management](https://wordpress.org/plugins/tags/media-management/)
   [redirects](https://wordpress.org/plugins/tags/redirects/)[seo](https://wordpress.org/plugins/tags/seo/)
 *  [Advanced View](https://wordpress.org/plugins/linko-media-path-mapper-and-swapper/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/linko-media-path-mapper-and-swapper/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/linko-media-path-mapper-and-swapper/reviews/)

## Contributors

 *   [ ajiajish ](https://profiles.wordpress.org/ajiajish/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/linko-media-path-mapper-and-swapper/)