Dprime Plugins
Cart

Media Replace help file

Installation, everyday use, troubleshooting, and technical reference for version 1.4.1.

Admin & developer tools
On this page

Overview

WordPress has no built-in way to replace a media file. The usual workaround is to upload a new one and manually update every page, post, and template that references the old file. This plugin removes that work.

Replaces in place. The attachment ID stays the same so every existing reference updates automatically. Old thumbnails are deleted and regenerated.

Allowed: jpg, png, gif, webp, avif, svg.

Before you start

  • WordPress 6.4 or newer
  • PHP 8.2 or newer

Installation

  1. Upload the dprime-media-replace folder to /wp-content/plugins/.
  2. Activate Dprime Media Replace in WordPress.
  3. Open the plugin settings and review the available options.

Using the plugin

  • Media Library list view: Replace file row action
  • Media modal when editing posts: Replace file link in the sidebar
  • Edit Media screen: Replace file meta box

Styling and CSS classes

These public-facing class hooks are present in the plugin styles. Add custom CSS only after checking the result on a staging site.

.dp-badge.dp-badge-err.dp-badge-off.dp-badge-ok.dp-badge-wait.dp-btn-danger.dp-btn-ghost.dp-hd.dp-hd-actions.dp-hd-mark.dp-hd-text.dp-help.dp-input.dp-input-full.dp-lbl.dp-mr-chosen-info.dp-mr-chosen-meta.dp-mr-chosen-name.dp-mr-chosen-remove.dp-mr-chosen-thumb.dp-mr-dropzone.dp-mr-dropzone-chosen.dp-mr-dropzone-icon.dp-mr-dropzone-idle

Data and cleanup

  • Content metadata: _wp_attached_file

Retention: kept until the plugin is uninstalled. Uninstall policy: delete the plugin-owned data declared above.

Troubleshooting

  1. Confirm the required WordPress, PHP, and companion-plugin versions above.
  2. Save the plugin settings again, then repeat the exact action that failed.
  3. Clear page, object, and browser caches when the issue affects front-end output.
  4. Temporarily test with unrelated plugins disabled on a staging site to identify a conflict.
  5. If the problem remains, record the steps, visible error, and relevant logs before contacting support.

Updates and access

Download the complete current package directly from Dprime Plugins. Install Dprime Core to receive eligible automatic updates and move older Dprime update addresses onto the current service.