Content Health

Inspects your WordPress media library and permalink layer for orphaned files, broken attachment references, and stale rewrite rules that quietly degrade user experience.

  • 4 Inspection Areas
  • 0 Database Writes
  • Read-Only Architecture

What This Module Does

WordPress sites accumulate content debt invisibly. Media files get deleted from the filesystem without the attachment record being removed. Images get uploaded but never attached to any post. Rewrite rules go stale after plugin changes but never get flushed. None of these cause obvious errors — they just quietly degrade performance, break images, and create 404 errors that erode WordPress SEO. Content Health surfaces all of it with purely observational reads.

Features at a Glance

WordPress Media Library Health

Checks every attachment record in wp_posts against the actual filesystem to detect missing physical files, unattached media (uploaded but not linked to any post), and attachments with broken or incomplete WordPress metadata.

WordPress Rewrite Rules Inspector

Lists all active WordPress rewrite rules, detects whether they are stale (out of sync with the current plugin and theme state), and identifies plugin-added rules that may conflict with each other — a common cause of WordPress 404 errors after plugin updates.

Broken WordPress Reference Detection

Scans post content for image and attachment references that point to media IDs that no longer exist in the database. Invisible to editors but they cause broken image placeholders for visitors and may affect page performance.

Purely Observational Architecture

Content Health never flushes WordPress rewrite rules, never modifies attachment records, and never deletes any media files. Every finding is a report — all remediation decisions remain entirely with you.

Why It Matters

  • Identify broken WordPress media before clients or site visitors notice missing images
  • Diagnose mysterious WordPress 404 errors caused by stale or conflicting rewrite rules
  • Quantify WordPress media library bloat from unattached uploads before storage audits
  • Catch broken WordPress attachment metadata that prevents image resizing and display
  • Include WordPress media library health findings in site audit reports for clients

Frequently Asked Questions

How does the module check if physical WordPress media files exist?

It uses PHP's file_exists() function against the attachment's upload path derived from its metadata and WordPress's upload directory configuration. It does not make HTTP requests to verify image URLs.

Will checking the WordPress media library be slow on sites with thousands of images?

The check is batched and paginated to avoid memory exhaustion. On large WordPress media libraries the check may take several seconds but will not time out on standard hosting. Very large libraries (50,000+ attachments) include a note about expected processing time.

Can this module flush the WordPress rewrite rules it identifies as stale?

No — the module is strictly read-only. To flush WordPress rewrite rules, navigate to Settings › Permalinks and save without making any changes. This takes one second and is completely safe.

Is this available in the free Lite version?

No. Content Health is a Pro-exclusive module.

Find the Invisible WordPress Content Debt Slowing Down Your Site

Broken WordPress media, orphaned files, and stale rewrite rules — surfaced without touching a single byte of your data.

Get Full Pro Access

Content Health is included in every Pro plan alongside all seventeen diagnostic modules.

Get Pro Now

Try the Free Lite Version

Download Lite to get started with the nine core WordPress diagnostic modules — completely free.

Download Lite — Free