Empty Alt Image Container Swap
This plugin improves accessibility by converting figure tags to div tags for image blocks with missing alt text and hides captions for these images.
Use with caution
Empty Alt Image Container Swap works, but test it on a staging site before relying on it in 2026. Was last updated 4 months ago, and scores 49/100 on our health check.
- Small user base (<10 active installs)
- Very few reviews so far
How does it stack up?
Side-by-side on installs, updates, ratings & support
Daily downloads
Download spikes usually follow a new release — each site that auto-updates counts as a download.
Rankings
Where Empty Alt Image Container S… stands todayWordPress.org search rankings
Live position in the plugin search, top 100| Keyword | Position |
|---|---|
| accessibility | >100 |
| Alt Text | >100 |
| div | >100 |
| figure | >100 |
| images | >100 |
About Empty Alt Image Container Swap
From the official readme · v1.1.1Description
This plugin enhances the accessibility of image blocks in the WordPress block editor by converting the wrapping <figure> tags to <div> tags when the image has an empty alt attribute. Additionally, it hides the caption for images with empty alt text on the frontend.
Key features:
– Converts <figure> tags to <div> tags for images with empty alt text
– Hides captions for images with empty alt text on the frontend (output a warning to the editor)
– Works dynamically without modifying stored content
Images that are purely decorative and lack an alt attribute do not contribute directly to the understanding of the content, and therefore, wrapping them in a <figure> element is not appropriate.
By replacing <figure> tags with <div> tags for images missing alt text, this plugin ensures proper HTML semantics. <div> elements are generic containers without implicit meaning, making them suitable for presenting images without associated descriptions.
Installation
There are two ways to install the “Empty Alt Image Container Swap” plugin:
-
Upload and Install Manually
- Download the plugin ZIP file to your computer.
- Log in to your WordPress admin dashboard.
- Navigate to Plugins > Add New > Upload Plugin.
- Click “Choose File” and select the downloaded ZIP file.
- Click “Install Now” to upload and install the plugin.
- Once installed, click “Activate Plugin” to activate it.
-
Install from WordPress.org Directory
- Log in to your WordPress admin dashboard.
- Navigate to Plugins > Add New.
- Search for “Empty Alt Image Container Swap” in the search field.
- Find the plugin in the results and click “Install Now”.
- Once installed, click “Activate Plugin” to activate it.
After activating the plugin through either method, it will automatically convert <figure> tags to <div> tags for image blocks with missing alt text when rendering pages. No further configuration is required.
For best accessibility practices, it’s recommended to provide descriptive alt text for all images. However, if you forget or choose not to add alt text for certain images, this plugin ensures proper markup by using <div> containers instead of <figure>.
Frequently asked questions
What happens if I deactivate the plugin?
When you deactivate the plugin, all image blocks will immediately revert to their original state. The plugin does not make any permanent changes to your content, so you don’t need to update or edit anything after deactivation.
Why are captions hidden for images with empty alt text?
Captions are typically used to provide additional context or information about an image. For decorative images (those with empty alt text), captions are usually unnecessary and may even cause confusion, which is why they are hidden.
Can I still add captions to images with empty alt text in the editor?
Yes, you can still add captions to images with empty alt text in the editor. However, these captions will not be displayed on the frontend while the plugin is active.
Does this plugin modify my database or stored content?
No, this plugin does not make any changes to your database or stored content. It works dynamically when pages are rendered, which means your original content remains intact.
Changelog
This update adds the ability to hide captions for images with empty alt text and improves the plugin's performance. The plugin now works dynamically, ensuring your original content remains unchanged.
1.1.1
- Fixed JavaScript translations not working by adding wp_set_script_translations()
- Tested up to WordPress 7.0
1.1.0
- Added feature to hide captions for images with empty alt text on the frontend
- Improved code for handling empty alt text cases
- Updated plugin to work dynamically without modifying stored content
1.0.4
- Initial release
For developers
Is this your plugin? Show off the numbers.
Add a live badge to your site, docs or GitHub README. It updates on its own — no account needed.
Best Empty Alt Image Container Swap alternatives
All accessibility plugins →
FAQ
Empty Alt Image Container Swap: quick answers
Straight answers, pulled from live WordPress.org data.
Live data from WordPress.org · checked Oct 5, 2026
Is Empty Alt Image Container Swap free?
Yes. Empty Alt Image Container Swap is free to download and use from the official WordPress.org plugin directory.
Is Empty Alt Image Container Swap safe to use in 2026?
Empty Alt Image Container Swap works, but test it on a staging site before relying on it in 2026. Was last updated 4 months ago, and scores 49/100 on our health check.
How many websites use Empty Alt Image Container Swap?
Empty Alt Image Container Swap is active on <10 WordPress websites and has been downloaded 1,399 times since it launched in July 2024. It was downloaded 45 times in the last 30 days.
Does Empty Alt Image Container Swap work with WordPress 7.1?
Empty Alt Image Container Swap is officially tested up to WordPress 7.0.6, while the latest release is 7.1.2. It may still work, but try it on a staging site first.
When was Empty Alt Image Container Swap last updated?
The latest version, 1.1.1, was released on May 24, 2026 (4 months ago).
Who makes Empty Alt Image Container Swap?
Empty Alt Image Container Swap is developed and maintained by Akari Doi.
What are the best alternatives to Empty Alt Image Container Swap?
The most popular alternatives to Empty Alt Image Container Swap are Web Accessibility (formally… (500K+ installs), Auto Image Attributes From… (100K+ installs) and Accessibility by UserWay (80K+ installs).
Powered by PageForge
Want thousands of pages that rank like these? Build them in an afternoon.
This directory runs on the same engine as PageForge. Turn any spreadsheet, CSV or API into thousands of fast, SEO-ready WordPress pages — with schema, internal links and AI-written copy baked in.
- CSV, Google Sheets & API data sources
- AI content, schema & internal links per page
- Works with Elementor, Gutenberg, Yoast & Rank Math
- Free on WordPress.org — no credit card
