Help wanted for new WordPress plugin: Media Ally

During the monster content audit I’ve been working on, I realized that there was no easy way to get a list of all the uploaded images in WordPress that are missing alternative text for screen readers. So I wrote a plugin to create an accessibility report for media files. It’s called Media Ally, and it’s on GitHub as well as

Right now, it does two things. It adds a report (currently under Settings, which might not be the best place for it) that gives you a list of image files that don’t have alt text. There’s an option at the bottom of this page to add a column to the Media Library. (Which really should be on the Media Settings screen instead… I’ll add that to the to do list.) When that’s enabled, you’ll see an Alt/Transcript column with a check mark, if the image has alt text, or a link to the edit screen if it doesn’t.

Screenshot of the Media Library with the new alt/transcript column added by the Media Ally plugin

So far, so good. But what about audio and video transcripts? Here’s where things get trickier, and I would love some input from the community.

Should we…

  1. Get audio/video files whose parents have empty content?
  2. Get all audio/video post formats with empty content other than the embed/shortcode?
  3. What about embedding YouTube videos? Should we prompt the user to include a link to the transcript? Would users even know how to find that?
  4. all of the above?
  5. other?

What do you think?

This is an excerpt from Content Strategy for WordPress.My latest books are Content Strategy for WordPress (2015) and WordPress for Web Developers (2013). Sign up to be notified when I have a new book for you.


  1. says

    I think the main problem here is that WordPress doesn’t have a default field for transcripts. There is no canonical source to look for.

    Embedded videos from other source might offer links to transcripts in their embedded content. Almost impossible to test.

    You should open a Trac ticket or ask on A built-in API is the only way to solve this.

    • says

      Actually, it’s getting better. In 3.6, the various formats store their URLs separately. You can see a little bit of this in the make/core post on audio and video support; I noticed it as I was working with a beta site’s database. That means it’ll be easier to search for A/V posts with empty content. All the same, this still a) covers only post formats, which aren’t widely used yet, and b) doesn’t cover pre-3.6 content.

      I’m thinking the administration screen might have to ask the user where transcripts are stored. Checkboxes:
      – post content
      – custom field [name:____]
      – none (I post links to others’ media; I do not upload my own and will not provide transcripts)

Leave a Reply

Your email address will not be published. Required fields are marked *