Title: Block Audit Author: Hiral Solanki Published: October 2, 2026 Last modified: October 2, 2026 --- Search plugins ![](https://ps.w.org/block-audit/assets/banner-772×250.jpg?rev=3724565) ![](https://ps.w.org/block-audit/assets/icon-256x256.jpg?rev=3724565) # Block Audit By [Hiral Solanki](https://profiles.wordpress.org/hiral26/) [Download](https://downloads.wordpress.org/plugin/block-audit.zip) * [Details](https://wordpress.org/plugins/block-audit/#description) * [Reviews](https://wordpress.org/plugins/block-audit/#reviews) * [Installation](https://wordpress.org/plugins/block-audit/#installation) * [Development](https://wordpress.org/plugins/block-audit/#developers) [Support](https://wordpress.org/support/plugin/block-audit/) ## Description Block Audit is a content QA tool for the block editor. It scans the blocks in the post you are editing, including nested blocks, and lists likely problems in a ** Block Audit** sidebar. Click **Go to block** on any issue to select the block, scroll it into view and highlight it. The plugin works with core WordPress blocks. It does not need a page builder, an external service or an account. #### What it checks **Accessibility** * Images with missing, empty or placeholder-like ALT text (for example, a file name) * Linked images without a text alternative * Empty headings * Skipped heading levels (reported as a warning, since some jumps are intentional) * Links and buttons without readable text * Links that open in a new tab without saying so * Videos without a captions track **Performance risks** * Large image files (thresholds are configurable) * Images with very large dimensions * Pages with many images * External embeds and iframes (YouTube, Vimeo, maps, social embeds and more) **Structure** * Empty Group, Columns, Column, Buttons, List, Gallery and Quote blocks * Image, video, audio and embed blocks without media * Very deeply nested blocks * Missing or invalid blocks, plus a notice for custom blocks it can’t check in detail **Content** * Very long paragraphs * Empty paragraphs and list items * Duplicate headings #### Scores Each category gets a score from 0 to 100, and the overall score is the average of those. The rules behind the numbers are listed in the sidebar under **About this score**. This is a plugin-generated content health score. It is **not** a Lighthouse, PageSpeed, Core Web Vitals, SEO or WCAG compliance score. Automated checks only catch some problems, so you still need to review your content yourself. #### Safe fixes only * Remove empty blocks with one click. * Type ALT text for an image straight from the issue. The plugin never generates ALT text for you. * Heading problems come with guidance. Heading levels are never changed automatically. * Ignore an issue you have reviewed. Ignored issues don’t count toward the score, and you can restore them at any time. #### For developers Register your own checks in JavaScript with the `blockAudit.checks` filter, or in PHP with the `block_audit_checks` filter. See `docs/DEVELOPER.md` in the plugin folder. The editor script in `build/` is compiled from the unminified source in `src/`. To rebuild it, run `npm install` and then `npm run build`. ### Privacy This plugin does not: * send your content or any other data to external services * make remote requests * use tracking, analytics or cookies All analysis happens in your browser and on your own server. The plugin stores only its settings (the `block_audit_settings` option), the list of ignored issues per post (post meta), and short-lived cached scan reports (transients). Deleting the plugin removes all of them. ## Screenshots [⌊The Block Audit sidebar with the overall score, category scores and counts.⌉⌊The Block Audit sidebar with the overall score, category scores and counts.⌉[ The Block Audit sidebar with the overall score, category scores and counts. [⌊Issues grouped by block, with Go to block, Remove block and Ignore actions.⌉⌊Issues grouped by block, with Go to block, Remove block and Ignore actions.⌉[ Issues grouped by block, with Go to block, Remove block and Ignore actions. [⌊Entering ALT text directly from an issue.⌉⌊Entering ALT text directly from an issue.⌉[ Entering ALT text directly from an issue. [⌊The toolbar indicator on a block that has warnings.⌉⌊The toolbar indicator on a block that has warnings.⌉[ The toolbar indicator on a block that has warnings. ## Installation 1. Upload the `block-audit` folder to `/wp-content/plugins/`, or install the plugin from the Plugins screen. 2. Activate the plugin. 3. Open any post or page in the block editor. Then click the Block Audit icon in the top toolbar, or choose **Block Audit** from the Options (⋮) menu. 4. Optional: adjust thresholds under **Settings Block Audit**. ## FAQ ### Does this plugin guarantee WCAG compliance? No. It flags common, detectable problems. Many accessibility requirements can only be checked by a person, for example whether ALT text is accurate or whether content makes sense to someone using a screen reader. ### Will this improve my Google rankings or PageSpeed score? The plugin doesn’t measure or promise search rankings, PageSpeed, Lighthouse or Core Web Vitals results. Its performance checks point out content that is often worth reviewing, such as large images and third-party embeds. ### Why is an image with empty ALT text only a warning? Decorative images should have empty ALT text. The plugin can’t tell whether an image is decorative, so it asks you to check. If the image is decorative, click **Ignore**. ### Does it slow down my site? No. Nothing loads on the front end of your site. In the editor, the scan runs in your browser, is debounced while you type, and fetches image file sizes in a single batched request. ### Does it work with custom or third-party blocks? Custom blocks are listed with a notice that detailed checks aren’t available for them, and they never break the scan. Developers can add checks for their own blocks. ### Where are ignored issues stored? In post meta (`_block_audit_ignored`) on the post being edited. Post content is never changed to store scanner state. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Block Audit” is open source software. The following people have contributed to this plugin. Contributors * [ Hiral Solanki ](https://profiles.wordpress.org/hiral26/) [Translate “Block Audit” into your language.](https://translate.wordpress.org/projects/wp-plugins/block-audit) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/block-audit/), check out the [SVN repository](https://plugins.svn.wordpress.org/block-audit/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/block-audit/) by [RSS](https://plugins.trac.wordpress.org/log/block-audit/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.0 * First release: accessibility, performance, structure and content checks, category and overall scores, jump to block, safe fixes, ignore rules, settings and developer filters. ## Meta * Version **1.0.0** * Last updated **1 day ago** * Active installations **Fewer than 10** * WordPress version ** 6.6 or higher ** * Tested up to **7.1.2** * PHP version ** 7.4 or higher ** * Tags * [accessibility](https://wordpress.org/plugins/tags/accessibility/)[blocks](https://wordpress.org/plugins/tags/blocks/) [developer-tools](https://wordpress.org/plugins/tags/developer-tools/)[gutenberg](https://wordpress.org/plugins/tags/gutenberg/) [performance](https://wordpress.org/plugins/tags/performance/) * [Advanced View](https://wordpress.org/plugins/block-audit/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/block-audit/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/block-audit/reviews/) ## Contributors * [ Hiral Solanki ](https://profiles.wordpress.org/hiral26/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/block-audit/)