Media Rename — OrbitStem Icon

Media Rename — OrbitStem

By Pratik Prajapati

Active Installs

30+

Last Updated

October 1, 2026

First Released

June 4, 2026

Download History (Last one month)


Media Rename — OrbitStem lets you safely rename images, videos, PDFs, and any media files in the WordPress Media Library without breaking your site — and automatically cleans up filenames the moment files are uploaded.

Before you rename, you see an impact report and dry-run preview showing where the file is used. When applied, the plugin performs batched, resumable URL replacement across posts, pages, custom fields, page builders (Elementor, Divi, Bricks, Breakdance), and site options. Old file URLs automatically 301 redirect to the new filenames to protect your Google rankings and external backlinks.

Single & Bulk Rename Features

  • Media Rename Panel — Embedded seamlessly into the Media Library modal and attachment edit screen
  • Bulk Rename from List View — Select multiple items in Media Library list view and rename them using pattern templates like {post-title}-{counter}, {year}, {category}, {author}, or {original}
  • Dry-Run Preview Table — Inspect current vs proposed filenames and collision warnings before anything touches your database or disk
  • Batched, Resumable URL Updates — Chunked database processing with an animated progress bar and automatic WP-Cron background continuation so large sites never time out
  • Automatic 301 Redirects — Efficiently intercepts 404 requests for old image paths and redirects visitors and search engines to new filenames
  • Rename History Log — Complete site-wide table of all past renames with one-click rollback for any individual entry
  • Duplicate Conflict Handling — Detects disk conflicts and auto-resolves with numbered suffixes (filename-1.jpg) to prevent accidental overwrites
  • Cache & Meta Purging — Automatically flushes Elementor generated CSS, Divi transients, Bricks caches, Yoast OG images, Rank Math image caches, and page caches
  • Impact Report & SEO Score — Real-time filename SEO score and usage breakdown across content, custom fields, and featured images
  • Quick-Fill Suggestions — One-click suggestions from image title, alt text, or parent post slug

Expanded Auto-Rename Rules on Upload

Stop uploading messy files like DSC01234_20240101_123456.jpg or f47ac10b-58cc-4372-a567-0e02b2c3d479.png. Set rules once and every upload is cleaned automatically:

  • Camera & Date Stripping — Automatically removes camera timestamps (20240101_123456, 2024-01-01) and camera model prefixes (DSC01234, IMG_4832)
  • UUID & Hash Stripping — Strips random 36-char UUIDs and 32-char MD5 hashes generated by scanners and smartphone cameras
  • Stopword Removal — Removes filler words (the, and, or, in, on, with, for, at, a, an) for concise, SEO-focused filenames
  • Max Filename Length — Safely truncates extra-long filenames at word boundaries
  • Force Lowercase & Clean Separators — Replaces spaces and underscores with clean hyphens
  • Parent Post Slug & Custom Prefix — Automatically prepend article slugs or custom brand tokens ({year})
  • Multilingual Transliteration — Accented Latin characters (é, ü, ñ, ø) are transliterated automatically using remove_accents()

WordPress Playground Sandbox

Test the entire plugin instantly in your browser without installing anything locally using our official WordPress Playground Blueprint:
https://playground.wordpress.net/?blueprint-url=https://raw.githubusercontent.com/pratik2198/orbitstem-media-rename/trunk/blueprint.json

Privacy & Security

This plugin does not contact external servers, track users, or collect personal data. All processing runs locally on your WordPress site.

  1. Upload the orbitstem-media-rename folder to /wp-content/plugins/
  2. Activate the plugin through the Plugins menu in WordPress
  3. Open Media Library, select a file, and use the Media Rename panel
  4. Or go to Media Media Rename to configure auto-rename rules, bulk rename items, and inspect the history log
Who can rename media files?

Administrators by default (manage_options). Developers can customize this with the orbitstem_rename_capability filter:

add_filter( 'orbitstem_rename_capability', function() {
    return 'edit_posts';
} );

To allow authors and contributors with upload permissions to rename their own attachments:

add_filter( 'orbitstem_allow_editors_to_rename', '__return_true' );

Will renaming break external links or search engine rankings?

No! Media Rename automatically creates 301 Permanent Redirects for all renamed files. If Google or an external blog links to the old image URL, WordPress redirects them directly to the new file URL.

How does batched URL replacement work?

Instead of trying to update all database tables in a single PHP request (which causes timeouts on large sites), Media Rename processes posts, postmeta, options, termmeta, and usermeta in manageable chunks. A real-time progress bar shows completion percentage, and WP-Cron acts as a safety net if your browser window closes.

Can I rollback any rename from the past?

Yes. Navigate to Media Media Rename Rename History. Every rename event is logged, and you can click Rollback on any individual entry to restore the original file and reverse site-wide URL updates.

Which page builders and caching plugins are supported?

Media Rename automatically purges caches and updates serialized/JSON URLs for:
* Elementor (including generated CSS cache regeneration)
* Divi Builder (transients and et-cache clearing)
* Bricks Builder
* Breakdance
* Beaver Builder
* WPBakery Page Builder
* WordPress Block Editor (Gutenberg)
* Yoast SEO & Rank Math OpenGraph image caches
* WP Rocket, LiteSpeed Cache, W3 Total Cache, WP Super Cache, Autoptimize

Changelog

1.8.0

  • Batched, Resumable URL Replacement: Chunked background processing for posts, postmeta, options, termmeta, and usermeta with real-time progress bar and WP-Cron safety net.
  • Bulk Rename from Media Library List View: Integrated bulk action for selected items, customizable pattern templates ({post-title}-{counter}, {year}, {category}, {author}, {original}), and dry-run preview table.
  • Rename History Log: Complete site-wide history table tracking all past renames with individual rollback functionality for any past entry.
  • Automatic 301 Redirects: Intercepts 404 requests for old image paths and redirects to new filenames, preserving SEO rankings and external hotlinks.
  • Expanded Auto-Rename Rules: Added camera/date stamp removal (20240101_123456, DSC01234), UUID & hash removal, stopword stripping, max filename length setting, and new dynamic tokens.
  • Duplicate Filename Conflict Handling: Pre-rename collision detection with clear UI warnings and automatic counter suffix resolution (filename-1.jpg).
  • Cache & Meta Purging: Automatic cache invalidation for Elementor CSS, Divi transients, Bricks, Beaver Builder, Yoast SEO, Rank Math, and page caching plugins.
  • Unified Naming: Standardized all UI, menu items, meta boxes, and panels to consistently read “Media Rename”.
  • WordPress Playground Blueprint: Added blueprint.json in plugin root for instant 1-click browser testing.
  • Tested up to WordPress 7.1: Full compatibility validation with the latest WordPress core release.

1.7.0

  • Added Auto-rename on upload — rules engine that cleans filenames before any file is saved to disk.
  • Force lowercase, replace underscores/spaces with hyphens, strip junk prefixes (IMG_, DSC_, screenshot-), prepend parent post slug, and custom prefix.
  • Live preview on the settings page — see exactly what a filename will become before saving rules.
  • Gutenberg and block editor support for post slug detection via Classic Editor, media modal, REST API, and Referer fallback.
  • Multilingual filename handling — accented characters transliterated to ASCII automatically.

1.6.0

  • Added support for international filenames — French, Japanese, Chinese, and other languages.
  • Lowered minimum PHP requirement to 7.4.
  • Fixed media rename panel breaking on Windows after the first rename (path slash mismatch).
  • Store relative upload paths and auto-repair broken attachment meta when possible.

1.0.0

  • Initial release.
<br />
<b>Warning</b>:  Undefined array key /home/ylinkin/truewp.net/wp-content/plugins/truewp-plugin-info/truewp-plugin-info.php on line 756
" width="120" height="120">

Available Versions

Version Download Type
1.8.0 Download Stable
1.7.0 Download Stable
1.6.0 Download Stable
1.5.1 Download Stable
1.5.0 Download Stable
1.0.1 Download Stable
Development Download Trunk

Plugin Info

  • Version: 1.8.0
  • Last Updated: October 1, 2026
  • Active Installs: 30+
  • WordPress Version: 6.0 or higher
  • Tested up to: 7.1.3
  • PHP Version: 7.4 or higher
  • Tags:    
    file-rename images media-library rename seo

Ratings


0.0 out of 5 stars. (0 reviews)

See all reviews
Scroll to Top