Description
This plugin applies the accessibility fixes that Alexibility’s specialists prepare and approve for your site. It
doesn’t change anything by itself, so installing it doesn’t make a site accessible on its own.
Not working with us yet? Open Tools → Accessibility Fixes after you activate the plugin. It takes a quick look at your
media library and published pages. It lists the newest images that have no alt text, each with a link to add it, and
the pages and posts with images that have no alt attribute. It also counts your PDFs and offers a
free scan of up to 50 pages of your site, with a report of what needs fixing and
how we would fix each problem in WordPress. The quick look reads your database only; nothing is sent anywhere.
On every site, the plugin adds:
- An “Alt text” column to the Media Library’s list view, showing each image’s alt text or “Missing”.
- A Site Health test that counts the images in your media library without alt text. The result turns good once every
image has alt text.
On a site that isn’t working with us yet, an administrator also sees a one-time notice on the Plugins screen, links to
the free scan and a sample report in the plugin’s row, and an “Accessibility quick look” dashboard widget with the same
counts. The widget has a “Don’t show this again” link, and it goes away by itself when no image is missing alt text or
once the site works with us.
Alexibility scans your site and a specialist reviews every fix. The fixes reach your site in one of two ways:
- You approve the Alexibility workbench’s access on WordPress’s own “Authorize application” screen, and the
workbench sends the approved fixes, previews them and applies them for you. You can revoke its access any
time under Users → Profile → Application Passwords. - Or you receive a fixes.json file, upload it under Tools → Accessibility Fixes, review what will change, and
press Apply.
Fixes saved into your site (they stay even if you remove the plugin):
- Image descriptions (alt text) in the media library and in existing pages, posts and block templates.
- Names for icon-only links and buttons and unlabeled form fields in saved content.
Theme-level fixes applied while pages are displayed (no JavaScript, no toolbar):
- Page language, a “Skip to content” link, visible keyboard focus and readable text contrast.
- Alt text and names for images and controls your theme outputs.
- Markup the Alexibility scanner tested in your pages: old align attributes, tabs marked as buttons, and a second
banner landmark inside the content.
Accessible copies of your PDFs (tagged, titled, with a language and descriptions) replace the originals at the same
addresses, so every link keeps working. A file is replaced only if it is still exactly the one Alexibility checked,
the original is kept in a backup folder in uploads, and Tools → Accessibility Fixes puts the originals back with one
click.
Every content change is logged with its previous value and WordPress keeps a revision, so a run can be rolled
back. A page someone edited after the fix is never overwritten.
When the fixes change (applied, rolled back, switched on or off), the plugin asks the page cache to start over, so
visitors get the new pages: Nginx Helper, LiteSpeed Cache, WP Rocket, W3 Total Cache, WP Super Cache, WP Fastest
Cache, Cache Enabler, Breeze, Hummingbird, SiteGround Speed Optimizer, Pantheon, SpinupWP and WP Engine. Another
cache can hook into the alexibility_fixes_purge_cache action.
Once fixes from Alexibility are applied, you can turn on a small “Accessibility by Alexibility” badge at the bottom
of each page under Tools → Accessibility Fixes. It links to alexibility.com/badge/, which explains what the badge
means. If your site has an accessibility statement, choose its page there too, and an “Accessibility statement” link
appears beside the badge. The badge is off until you turn it on, and it goes away if every run is rolled back. The
plugin makes no outside connections: the workbench calls the site, never the other way round, and the links to
alexibility.com only open it in your browser.
FAQ
Will installing this plugin make my site accessible?
No. It applies fixes that an Alexibility specialist has prepared and approved for your site; on its own it changes
nothing. The plugin’s page shows a quick look at your images and PDFs and a link to request a free scan.
What does it cost?
The plugin, the quick look and the scan of up to 50 pages are free. Fixing is a paid service: after your scan we send
you a fixed price, based on how many fixes it found, and nothing starts until you accept it. Our prices are at
https://alexibility.com/pricing/.
Does the plugin send anything to Alexibility?
No. The quick look, the Site Health test and the dashboard widget read your own database. The free-scan buttons and
links open our request form on alexibility.com in your browser, with your site’s address filled in and
via=wordpress-plugin added, so we know the request came from the plugin. The plugin sends nothing by itself, and
nothing reaches us until you submit that form yourself. If you turn on the footer badge, its link to
alexibility.com/badge/ carries your site’s host name and ref=badge, so we can tell which site a visitor came from. Our
privacy policy is at https://alexibility.com/privacy/.
How do I hide the dashboard widget?
Choose “Don’t show this again” at the bottom of the widget. That hides it for you only; other administrators choose for
themselves. You can also hide it from Screen Options on the dashboard. The widget goes away by itself when no image is
missing alt text, or once your site works with Alexibility.
Can I change where the badge links?
No. The badge carries Alexibility’s name, so it always links to Alexibility’s page about the badge. To send visitors
to your own accessibility statement, choose its page under Tools → Accessibility Fixes: an “Accessibility statement”
link to it appears beside the badge. Only pages published on your site can be chosen.
Changelog
0.5.4
- Tools → Accessibility Fixes lists the 10 newest images without alt text, each with a link to add it, and the published pages and posts with images that have no alt attribute. “Check again” counts again; otherwise the result is kept for up to 12 hours, or until an image or a published page changes.
- A Site Health test for images in the media library without alt text.
- An “Alt text” column in the Media Library’s list view.
- On a site that isn’t working with Alexibility yet: the Plugins screen notice says how many images have no alt text, the plugin’s row links to a free scan and a sample report, the plugin’s page explains what happens if you hire us, and a dashboard widget shows the counts until you hide it or nothing is left to report.
- The plugin’s page on alexibility.com is now https://alexibility.com/wordpress-plugin/.
0.5.3
- The footer badge always links to alexibility.com/badge/, which explains what the badge means. The “Badge link” setting, which took any address, is gone.
- A site can choose its accessibility statement from its own published pages, and the badge shows an “Accessibility statement” link to it.
0.5.2
- On a site that isn’t working with Alexibility yet, Tools → Accessibility Fixes explains what the plugin does, takes a quick look at the media library and published content (images without a description or alt attribute, PDFs) and links to a free scan. A one-time notice on the Plugins screen points to it.
- The footer badge can be turned on only while fixes from Alexibility are applied on the site.
0.5.1
- Adds the fixes’ CSS and the badge’s CSS through WordPress’s style functions instead of printing style tags.
- Uses the plugin’s full prefix for its constants, temporary notices, error codes and CSS classes. To change the badge’s brand in wp-config.php, define ALEXIBILITY_FIXES_BRAND_NAME and ALEXIBILITY_FIXES_BRAND_URL.
0.5.0
- Replaces PDFs with the accessible copies Alexibility made, at the same addresses, from the workbench (media library items and files in the uploads folder). A file someone changed since the audit is left alone. The originals are kept in a backup folder and can be put back from Tools → Accessibility Fixes or the workbench.
0.4.1
- Purges the page cache after the fixes change, so visitors don’t keep getting pages from before an apply.
- Adds a short stamp of the current fixes to each page (a meta tag), so the workbench can tell when a cache still serves an older page.
0.4.0
- Markup repairs the Alexibility scanner tried in the page and kept because the failure cleared and nothing moved: removes old align attributes (or moves them to CSS as text-align), marks tabs that say they are buttons as tabs, and removes a second banner landmark inside the content. Only the align and role attributes can be changed, and only from the value the scan found.
0.3.0
- Hides icons that only repeat their link’s or button’s name from screen readers (aria-hidden).
- Fills an empty alt on an image that is a link’s only content, when the fix gives it text.
- Layout repairs the Alexibility scanner checked in the page: more room around small controls, a box for links with no size of their own, and a background colour behind text on photos. Only spacing, display and background-colour values are accepted.
0.2.2
- Clearer names for the plugin’s functions and a simpler database query, after a Plugin Check review. No change in behavior.
0.2.1
- The footer badge is off until the site turns it on.
0.2.0
- REST routes for the Alexibility workbench (status, preview, apply, rollback), for administrators only.
0.1.0
- First release.
