Guide

Attachments Inspector troubleshooting

Mismatch cases and report access issues.

Case A vs Case B

CaseSymptomCauseFix
AToolbar offers immediate Fix MismatchLegacy CDN or /sites/N/ (N ≠ 20) src matches an attached filenameAccept Fix Mismatch to rewire id/url
BToolbar asks to search or importAttachment id is present but invalid, or filename ≠ srcPick a library match (reparents) or Import from URL

When both apply, Case A wins.

A core/image block with a working src and no id is not Case B.

Admin-bar mismatch count unexpected

Symptom: Admin bar shows mismatches you do not see in the editor.

Cause: Cached summary or blocks outside the open post (children not in the editor canvas).

Fix: Open the linked editor URL. Re-run wp prc attachments-inspector mismatch-report for a fresh batch CSV/JSON.

Attachment report blank

Symptom: ?attachmentsReport=1 shows an empty grid.

Cause: No attachments on the post/children, or mime filter excludes them.

Fix: Confirm media is parented to the post. Try without a restrictive mime_type in the report REST call. Ensure report assets enqueue (query var must be present).

Was this helpful?