Heading Image Matcher is a WordPress plugin that scans posts and pages for headings, then suggests relevant images from the media library for each section. Editors can review matches in the post editor, insert selected images, and keep content visually aligned without manually searching the media library.
The plugin focuses on practical editorial workflows: heading-aware matching, Gutenberg-safe image insertion, Classic Editor support, featured image assignment by slug, cached match results, and background processing for larger tasks.
WordPress Plugin
● WordPress.org review — v3.0.7
Heading Image Matcher.
Match media library images to post headings and insert them where they belong.
3.0.7
Version
6.0+
Requires WordPress
7.4+
Requires PHP
GPL-2.0-or-later
License
About the Plugin
Feature Index
F-01
Heading-aware matching
Scans H2-H6 headings and suggests relevant media library images for each content section.
F-02
Editor review workflow
Lets editors review image suggestions before inserting them into posts or pages.
F-03
Gutenberg-safe insertion
Builds WordPress image blocks in a validation-safe format instead of injecting fragile markup.
F-04
Featured image assignment
Can match post slugs to attachment slugs and assign featured images automatically.
F-05
Performance-conscious caching
Caches match results for unchanged posts and avoids full-library scans on every request.
F-06
Background processing ready
Uses queued workflows for heavier matching and bulk operations instead of blocking users.
Changelog
3.0.7
2026-07-04
Renamed to Heading Image Matcher, updated text domain and slug references, and tightened REST attachment permission checks.
3.0.0
2026-06-20
Rebuilt around a PSR-4 architecture, REST endpoints, background queue support, and safer Gutenberg insertion.