Title: Librizent &#8211; Media Library Health
Author: Muhammad Mujahid Sarfraz
Published: <strong>September 17, 2026</strong>
Last modified: September 17, 2026

---

Search plugins

![](https://ps.w.org/librizent-media-library-health/assets/banner-772x250.png?rev
=3700635)

![](https://ps.w.org/librizent-media-library-health/assets/icon.svg?rev=3700635)

# Librizent – Media Library Health

 By [Muhammad Mujahid Sarfraz](https://profiles.wordpress.org/mujahidwp/)

[Download](https://downloads.wordpress.org/plugin/librizent-media-library-health.1.0.2.zip)

 * [Details](https://wordpress.org/plugins/librizent-media-library-health/#description)
 * [Reviews](https://wordpress.org/plugins/librizent-media-library-health/#reviews)
 *  [Installation](https://wordpress.org/plugins/librizent-media-library-health/#installation)
 * [Development](https://wordpress.org/plugins/librizent-media-library-health/#developers)

 [Support](https://wordpress.org/support/plugin/librizent-media-library-health/)

## Description

Librizent is a lightweight Media Library health and audit plugin. It helps site 
owners find review-worthy media issues before they become website problems.

Librizent is not an image optimization plugin. It does not compress, replace, rename,
or automatically delete media. It does not automatically write ALT text.

The workflow is deliberately safe: **Scan  Review  Decide**.

#### Features

 * Media Health Score calculated from actual scan results.
 * Missing ALT text detection for images with completely empty ALT values.
 * Oversized image detection with a configurable pixel threshold.
 * Heavy image file-size detection with a configurable per-image MB threshold.
 * Missing or incomplete image dimension metadata detection.
 * Missing or unreadable local attachment file detection, with an offloaded-media
   caution.
 * Potentially poor filename detection using conservative filename patterns.
 * Possible duplicate detection using SHA-256 hashes where practical and metadata
   signatures as a fallback.
 * Possibly Unused Media review using WordPress-native attachment, featured-image,
   and content-reference checks.
 * Manual ALT text editing with capability and nonce checks.
 * Batched manual scanning designed to avoid loading the full Media Library into
   memory.
 * Batch-built usage index so post-content and featured-image checks are not repeated
   once per attachment.
 * Dedicated Media Usage workspace with Usage Found, Possibly Unused, and live attachment
   review states.
 * Scan History with up to 10 compact local summaries, score trends, issue totals,
   and scan duration.
 * Five focused admin destinations: Dashboard, Media Health, Media Usage, Scan History,
   and Settings.
 * No external services, registration, API keys, telemetry, tracking, or AI features.

#### Important safety note about unused media

Librizent intentionally uses the wording **Possibly Unused**. A WordPress media 
item can be referenced from custom fields, theme options, page builders, CSS, JavaScript,
WooCommerce data, or external integrations that this scanner cannot prove exhaustively.

Always review media in context before deleting it. Librizent does not provide automatic
deletion.

#### Health Score

The Media Health Score starts at 100. Each issue category has a maximum weight. 
The deduction for that category is proportional to the share of eligible media affected,
capped at the category’s maximum weight.

The score breakdown is shown in the admin so users can see exactly why the score
changed.

### Privacy

Librizent works locally inside your WordPress installation. It does not send Media
Library data, scan results, site information, or user information to external servers.
It does not use telemetry, tracking, remote APIs, external fonts, or third-party
JavaScript/CSS services.

The plugin stores its settings, the latest scan state/results, and up to 10 compact
scan-history summaries in WordPress options. These plugin-owned options are removed
by the included uninstall routine when the plugin is deleted through WordPress.

## Screenshots

[⌊Librizent Dashboard with purple/orange branding, overall score, scan action, and
issue cards.⌉⌊Librizent Dashboard with purple/orange branding, overall score, scan
action, and issue cards.⌉[

Librizent Dashboard with purple/orange branding, overall score, scan action, and
issue cards.

[⌊Missing ALT Text review with manual ALT editing.⌉⌊Missing ALT Text review with
manual ALT editing.⌉[

Missing ALT Text review with manual ALT editing.

[⌊Large Images review showing dimensions and file sizes.⌉⌊Large Images review showing
dimensions and file sizes.⌉[

Large Images review showing dimensions and file sizes.

[⌊Possibly Unused Media review with usage limitations explained.⌉⌊Possibly Unused
Media review with usage limitations explained.⌉[

Possibly Unused Media review with usage limitations explained.

[⌊Transparent score deduction breakdown.⌉⌊Transparent score deduction breakdown.⌉[

Transparent score deduction breakdown.

[⌊Media Usage workspace with usage-state filters and focused attachment review.⌉⌊
Media Usage workspace with usage-state filters and focused attachment review.⌉[

Media Usage workspace with usage-state filters and focused attachment review.

[⌊Scan History showing score trends, scan duration, and aggregate issue counts.⌉⌊
Scan History showing score trends, scan duration, and aggregate issue counts.⌉[

Scan History showing score trends, scan duration, and aggregate issue counts.

[⌊Heavy image file-size review with configurable threshold and file details.⌉⌊Heavy
image file-size review with configurable threshold and file details.⌉[

Heavy image file-size review with configurable threshold and file details.

[⌊Missing or unreadable local file review for broken attachment records.⌉⌊Missing
or unreadable local file review for broken attachment records.⌉[

Missing or unreadable local file review for broken attachment records.

[⌊Modern Settings screen for image dimension threshold, file-size threshold, and
review pagination.⌉⌊Modern Settings screen for image dimension threshold, file-size
threshold, and review pagination.⌉[

Modern Settings screen for image dimension threshold, file-size threshold, and review
pagination.

## Installation

 1. Upload the `librizent-media-library-health` folder to `/wp-content/plugins/`, or
    install the plugin ZIP through Plugins > Add New > Upload Plugin.
 2. Activate Librizent through the Plugins screen.
 3. Open Librizent > Dashboard.
 4. Select **Run Media Health Scan**.
 5. Review findings under Librizent > Media Health.
 6. Use Librizent > Media Usage to inspect usage signals, and Librizent > Scan History
    to compare completed scans.

## FAQ

### Does Librizent optimize or compress images?

No. Librizent is an audit and health tool, not an image optimizer.

### Does Librizent delete unused media?

No. It never automatically deletes media. The “Possibly Unused” result is a review
signal, not proof that a file is unused.

### Does Librizent automatically generate or change ALT text?

No. Librizent has no AI functionality and never writes ALT text automatically. Users
can manually save ALT text for a flagged image.

### Does Librizent send data to another server?

No. Librizent does not require an external service, API key, registration, telemetry,
or tracking.

### What does the heavy image file-size check do?

It flags readable local image files above the MB threshold you choose in Settings.
It does not compress, resize, replace, or otherwise modify the file.

### What does the missing or unreadable files check mean?

It means the attachment record did not resolve to a readable local source file during
the scan. This can indicate a broken migration or moved file, but sites that intentionally
offload media should verify their storage integration before treating a result as
broken.

### How are possible duplicates detected?

Readable local files up to a conservative size limit are compared with SHA-256 hashes.
Larger files use a metadata-based signature and remain explicitly labeled as possible
duplicates.

### Why can a file be marked Possibly Unused even if I use it?

Media can be referenced outside standard post content and featured images. Page 
builders, custom fields, theme options, CSS, JavaScript, ecommerce data, and external
integrations may store references in ways this lightweight scan does not inspect.

### Does the scan run on every admin page load?

No. Scans are manual and processed in small AJAX batches. Before attachment analysis,
Librizent builds a lightweight usage index from common WordPress content references
and featured images in batches, then reuses that index during the media scan. Stored
scan results are used for review pages until the next scan.

### What does the Media Usage page check?

It uses the latest manual scan to classify attachments when WordPress-native usage
signals were found or when an item was marked Possibly Unused. Opening Review Usage
performs a focused live lookup for attachment relationships, featured-image use,
and common post-content references. These checks are intentionally conservative 
and cannot prove that media is unused everywhere.

### What is stored in Scan History?

Librizent keeps up to 10 compact local summaries containing timestamps, scan duration,
Health Score, and aggregate counts. It does not duplicate full issue lists in history,
and clearing history does not delete media or the latest detailed scan.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Librizent – Media Library Health” is open source software. The following people
have contributed to this plugin.

Contributors

 *   [ Muhammad Mujahid Sarfraz ](https://profiles.wordpress.org/mujahidwp/)

[Translate “Librizent – Media Library Health” into your language.](https://translate.wordpress.org/projects/wp-plugins/librizent-media-library-health)

### Interested in development?

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

## Changelog

#### 1.0.2

 * Completed a WordPress.org guideline hardening pass against the current Plugin
   Directory guidance.
 * Added a direct-access guard to the root index file.
 * Added the Librizent audit capability check to manual ALT updates in addition 
   to attachment edit permission and nonce verification.
 * Added canonical UUID validation for AJAX scan identifiers before state comparison.
 * Standardized local file-size reads on WordPress core `wp_filesize()` for the 
   declared WordPress requirement.
 * Removed tier-related ambiguity from public copy and added an explicit local-only
   privacy disclosure.
 * Re-checked remote calls, bundled libraries, update mechanisms, executable downloads,
   input handling, output escaping, SQL preparation, internationalization, and uninstall
   cleanup.
 * Prepared the package for a clean Librizent WordPress.org submission.
 * Verified that the plugin folder, main plugin filename, and text domain all use`
   librizent-media-library-health`.
 * Removed the unused local translation Domain Path header so WordPress.org language
   packs can use the canonical plugin slug.
 * Hardened the default audit capability to administrators while keeping the capability
   filter available to developers.
 * Re-checked nonces, capability checks, sanitization, escaping, prepared database
   reads, direct-access guards, and uninstall cleanup.

#### 1.0.1

 * Renamed the plugin to Librizent – Media Library Health.
 * Updated plugin branding, internal identifiers, admin UI references, file names,
   and asset handles to Librizent.
 * Updated the WordPress.org text domain to `librizent-media-library-health`.
 * Bumped the plugin version to 1.0.1.

#### 1.0.0

 * Initial release.
 * Added batched Media Library health scanning.
 * Added missing ALT, oversized image, heavy image file-size, dimension, filename,
   duplicate, possibly-unused, and missing/unreadable file detectors.
 * Added transparent Media Health Score.
 * Added manual ALT editing, settings, usage review, and safe uninstall cleanup.
 * Added the polished purple/orange Librizent admin interface.
 * Added a dedicated Media Usage workspace with stored usage classification, filters,
   pagination, and focused live review.
 * Added compact Scan History with up to 10 local summaries, score trends, issue
   totals, scan duration, and protected history clearing.
 * Expanded the professional Librizent menu to five destinations: Dashboard, Media
   Health, Media Usage, Scan History, and Settings.
 * Improved large-library scan performance by building WordPress-native usage signals
   in batches instead of running content and featured-image lookups separately for
   every attachment.

## Meta

 *  Version **1.0.2**
 *  Last updated **6 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.4 or higher **
 *  Tested up to **7.1.1**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [accessibility](https://wordpress.org/plugins/tags/accessibility/)[Alt Text](https://wordpress.org/plugins/tags/alt-text/)
   [image audit](https://wordpress.org/plugins/tags/image-audit/)[media library](https://wordpress.org/plugins/tags/media-library/)
   [media management](https://wordpress.org/plugins/tags/media-management/)
 *  [Advanced View](https://wordpress.org/plugins/librizent-media-library-health/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/librizent-media-library-health/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/librizent-media-library-health/reviews/)

## Contributors

 *   [ Muhammad Mujahid Sarfraz ](https://profiles.wordpress.org/mujahidwp/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/librizent-media-library-health/)