Local WordPress media diagnostics

Make media lighter without losing the detail readers need

Devenia Speed Optimization helps you find large images and videos, check where they appear, and replace a chosen file with a smaller version. The complete plugin is free and runs on your WordPress installation.
Download Devenia Speed Optimization
A compact machine examining image and video files, with report and backup controls.

The smallest preview does not decide the file size

A product photograph may appear as a small card and as an enlarged detail view. Reducing the original to fit the card alone can leave the enlarged view soft.

Check the largest important use, the file the browser actually downloads and the display’s pixel density. A 600-pixel-wide display area at 2× density can need a 1200-pixel-wide image, provided the original has enough detail.

The illustration shows one photograph used at two scales. Keep the pattern clear in the larger view as you reduce the file’s dimensions and byte size.

One blue teapot photograph feeds a small preview and a larger detail view, where the etched leaf pattern remains clear.

One source, two uses: the small preview and the enlarged detail both need to work after replacement.

Read the file in its page context

A scan identifies candidates for review. Use the evidence to decide which file deserves work and what the replacement must preserve.

File weight and dimensions

Compare the attachment’s bytes, pixel dimensions and generated image sizes. A large original does not prove that every visitor downloads it; WordPress can serve a smaller responsive size.

Where the attachment appears

Review detected content references, block references and featured-image uses. Check important pages yourself, including enlarged views. A stored reference does not prove that a file is visible or loaded.

Measured display size

Page measurements come from an operator or integration; the plugin does not run a browser. Record relevant desktop and mobile dimensions and pixel density, then check the proposed target against every important use.

A compatible replacement

Supply a smaller file with the same MIME type and extension. Image replacements must not increase pixel dimensions and must keep the original proportions within one percent. A JPEG-to-WebP conversion needs a different media workflow.

Scan, prepare and replace one file at a time

The scan does not compress media. Prepare and inspect the smaller file separately. The admin page handles scans, settings, reports and restoration; replacement registration and application use WordPress abilities.

1. Run the local scan

Open Tools → Speed Optimization, review the settings and select Run local scan. The same scan is available with wp devenia-speed-optimization scan.

2. Review the real page uses

Start with one important page. Check the downloaded image, its display size and any enlarged view. An integration can read speed-optimization/list-render-candidates and save measurements with speed-optimization/record-render-measurements.

3. Prepare the smaller file

Use an image or video tool to prepare a separate replacement. Check sharpness, proportions and any required transparency or animation, then upload the checked file as another Media Library attachment.

4. Register and confirm

Use speed-optimization/create-repair-job, then speed-optimization/register-replacement with the original and replacement attachment IDs. Apply it through speed-optimization/apply-replacement with confirm: APPLY_REPLACEMENT. The plugin checks the file again and creates a local backup before replacing it.

5. Check the result

Clear the caches your site uses and open the affected pages on desktop and mobile. Check responsive images and enlarged views. If needed, restore through the admin backup controls or speed-optimization/restore-original with confirm: RESTORE_ORIGINAL.

Know the scope before you start

Requires WordPress 6.9 or later and PHP 7.4 or later. Scans and all abilities require site administration permission. Replacing or restoring a file also requires permission to upload files and edit the attachment.

Files must be available locally in WordPress uploads. Backups need disk space. Restore anything you need before uninstalling: removing the plugin deletes its settings and backup index.

Review the defaults

Fresh installations enable daily scans and email alerts for changed results, sent to the WordPress administrator address. Review these choices before leaving the plugin active.

The default scan checks the newest 250 attachments. The limit can be set from 25 to 5,000; a report retains up to 100 prioritised candidates. Savings and delay figures are estimates, not measured speed gains.

For developers and integrations

The plugin provides 15 abilities under speed-optimization/ for settings, scans, reports, measurements, repair jobs, replacements and backups. Use speed-optimization/get-settings to read the current configuration.

WordPress owns attachments and metadata. The plugin keeps the target attachment and its file URL during a same-format replacement. Page caches and the visual check remain part of your site’s normal workflow.

A compact machine examining image and video files, with report and backup controls.

Start with one image that matters

Install the plugin, review its settings and run a local scan. Choose one file used on an important page, then check what a smaller version must preserve.
Download Devenia Speed Optimization