How to Use Media Replacement in WordPress

Why You Need It

The default WordPress Media Library doesn’t have a replace function. To replace a file, you’d need to manually update every reference to the old file. Media Replacement automates this.

How to Enable this Feature

Step 1: Navigate to Settings

Click into the Classic Monks plugin settings, then the Performance tab, Media Enhancements subtab.

Step 2: Enable the Feature

Toggle on the feature.

Step 3: Save and Test

Click Save Changes. Test on the frontend.

Common Use Cases

Updating images

When you update a logo, product image, or any media file, Media Replacement ensures all references across the site are updated.

Fixing broken images

If an image file was accidentally deleted or corrupted, Media Replacement lets you upload a new file to fix all references.

Before you enable this feature

1. Test on staging first to verify no conflicts with your theme or other plugins
2. Check dependent plugins that may rely on the functionality being modified
3. Monitor after enabling for any unexpected behavior on the frontend

How it works under the feature

This feature runs during the WordPress initialization phase. When enabled, its PHP code registers hooks that modify specific WordPress behaviors. The changes are non-destructive and reversible.

No database schema changes are made. The feature state is stored as a boolean value in the wp_options table and can be toggled at any time from the admin settings.