Alt Text Tools

It’s very important for accessibility to have correct Alternative Text attributes set for all of your images. This CSV file will make it easy to find images that need to be fixed, so you can improve the accessibility on your site. Because the Alt Text is “hardcoded” into your posts and pages when you insert the image, it can be difficult to know which images don’t have Alt Text, or need better ones. (If you go back and add an Alt Text to an image in the media library, it won’t update your post content — so you need to look at the actual post itself.)

This image tutorial from w3.org is a great resource

Open the corresponding post in the editor (use the link in the edit link column to open the post that includes the corresponding image). Edit the image in the post, and add in the Alt Text there. Remember, this does not add the Alt Text to the image in the media library – that needs to be done separately.

Unfortunately, no. Once an image is inserted into a post, it’s “hardcoded” along with its Alt Text. So you’ll need to edit the actual post or page itself. If you add an Alt Text to the image in the media library (before it’s inserted into the post content), then it will be inserted with that Alt Text. Heads up! If you’re using the Block Editor, and if you use the “Image” block to insert an image and upload it directly into the block (Selecting an “Image” Block and then clicking the “Upload” button), it inserts the image and adds it to the media library before you can add the Alt Text. So…

The plugin scans all of your post and page content – and should also pick up any other custom post types. However, it will not include images that are used in your theme, or any auto-generated usage (like archive pages) – and it may miss a few others here and there. We recommend you also look around your site and check the Alt Text on images outside of posts manually, or use a third-party scanning tool to make sure nothing was missed.

For our first release, we wanted to make a tool that would be immediately useful. We plan on expanding it soon, to include a more user-friendly interface for finding (and fixing) Alt Text. If you have feature ideas, please let us know!

An empty (null) alt text, which is expressed like this in the code: alt="", we’ll note that they’re EMPTY. (This is generally considered the best practice for “decorative” images.) If the image has no alt attribute at all, then we’ll note that it’s MISSING.

The plugin attempts to find all the images that are actually used in your content, and then lists all of the images it finds, along with their corresponding Alt Text (or lack thereof) on each row in the spreadsheet. This way you can see which images have correct Alt attributes set, which are already compliant, and which may need to be improved. For example, if you had previously entered Pinterest descriptions in the Alt Text field, with lots of hashtags (which is not how the Alt attribute should be used), you can scan through each row of the spreadsheet to identify and fix those.

Most sites will generate the file in about 10-20 seconds. On sites with a lot of content, it may take several minutes. If you still don’t get the download file after waiting several minutes, ask your host to increase your PHP Memory Limit. In several cases, changing from 128MB to 512MB has solved this, but the actual limit necessary will depend on your site and your hosting. To increase the memory limit yourself, try adding this to your wp-config.php file: define( 'WP_MAX_MEMORY_LIMIT', '512M' ); You can also try changing the memory-limit line in PHP.ini: memory_limit = 512M ; You can also…

By default, only Administrators can access the tool. If you’d like to grant access to another role or user, you can use a role-management plugin such as User Role Editor to create and assign the manage_alt_text_tools capability. (The plugin doesn’t create or assign this capability itself — it simply honors it if you set it up.) You can also use the nerdpress_alt_text_tools_cap filter. For example, to enable access for Editors: add_filter( 'nerdpress_alt_text_tools_cap', function() { return 'edit_others_posts'; } );