ACCESSIBLE VIDEO: Use the Able Player Plugin for WordPress

Illustration of hands holding tablet while viewing videos

Need a fully-accessible cross-browser HTML5 media player for your WordPress website? Download the Able Player plugin by Terrill Thompson to embed audio or video within your WordPress page or post.

There are currently two ways to add an Able Player instance to a WordPress site:

  1. Enter or paste any valid HTML5 Able Player code into your web page. Full documentation is available on the Able Player project page on GitHub.
  2. Enter an shortcode. The shortcode is intended for adding videos hosted on YouTube or Vimeo, with captions and subtitles hosted on these services. For anything more complex, use HTML.

The shortcode

The shortcode supports the following attributes.

Required attributes (one of these)

  • youtube-id – 11-character YouTube ID
  • vimeo-id – Vimeo ID

Optional attributes

  • youtube-desc-id – YouTube ID of a described version of the video
  • vimeo-desc-id – Vimeo ID of a described version of the video
  • youtube-nocookie => “true” or “false” (use “true” to embed YouTube untracked, for added privacy)
  • id – a unique id for the player (if omitted, one will be automatically assigned)
  • autoplay – “true” or “false” (default is “false”)
  • loop’ – “true” or “false” (default is “false”)
  • playsinline – “true” or “false” (default is “true”). By setting to “false”, some devices (e.g., iPhones) will play the video in their own media player rather than in Able Player.
  • hidecontrols – “true” or “false” (default is “false”). Set to “true” to enable the player controls to fade away during playback. They will appear again if the user hovers over the player or pressing a key, and they are always accessible to screen reader users.
  • poster – the URL of a poster image, displayed before the user presses Play
  • width – a value in pixels (by default, the player will be sized to fit its container)
  • height – a value in pixels (by default, the height of the player will be in proportion to the width)
  • heading – The HTML heading level (1-6) of the visually hidden “Media Player” heading that precedes the player (for the benefit of screen reader users). If omitted, a heading level will be intelligently assigned based on context.
  • speed – “animals” or “arrows” (default is “animals”)
  • start – start time at which to start playing the media, in seconds. Some browsers do not support this.
  • volume – “0” to “10” (default is “7” to avoid overpowering screen reader audio). Some browsers do not support this.
  • seekinterval – number of seconds to forward/rewind with the Forward and Rewind buttons. If omitted, the interval will be intelligently assigned based on length of the video.
  • nowplaying – “true” or “false” to include a “Selected Track” section within the media player (default is “false”).

See code examples at the Able Player download page.


WEBSITE ACCESSIBILITY TESTING & REMEDIATION SERVICES: Mary Gillen is an experienced Website Accessibility Compliance Auditor and Remediator. She can test your website to determine if it meets accessibility standards:

WCAG 2.1: 312 checkpoints covering A, AA and AAA W3 accessibility guidelines
Section 508: 15 US federal guidelines covered by 59 accessibility checkpoints

Find out more about Mary Gillen’s Accessibility Testing & Remediation Services: Websites, PDFs, Office Docs & Videos