{"id":17419,"date":"2026-05-06T14:30:00","date_gmt":"2026-05-06T14:30:00","guid":{"rendered":"https:\/\/make.wordpress.org\/accessibility\/?p=17419"},"modified":"2026-05-06T03:07:51","modified_gmt":"2026-05-06T03:07:51","slug":"accessibility-ready-requirements-updated","status":"publish","type":"post","link":"https:\/\/make.wordpress.org\/accessibility\/2026\/05\/06\/accessibility-ready-requirements-updated\/","title":{"rendered":"Accessibility-Ready Requirements Updated"},"content":{"rendered":"<p class=\"wp-block-paragraph\">Effective today, the theme <span tabindex='0' class='glossary-item-container'>accessibility<span class='glossary-item-hidden-content'><span class='glossary-item-header'>Accessibility<\/span> <span class='glossary-item-description'>Accessibility (commonly shortened to a11y) refers to the design of products, devices, services, or environments for people with disabilities. The concept of accessible design ensures both \u201cdirect access\u201d (i.e. unassisted) and \u201cindirect access\u201d meaning compatibility with a person\u2019s assistive technology (for example, computer screen readers). (https:\/\/en.wikipedia.org\/wiki\/Accessibility)<\/span><\/span><\/span>-ready guidelines have been updated. The new guidelines more closely adhere to Web Content Accessibility Guidelines (<span tabindex='0' class='glossary-item-container'>WCAG<span class='glossary-item-hidden-content'><span class='glossary-item-header'>WCAG<\/span> <span class='glossary-item-description'>WCAG is an acronym for Web Content Accessibility Guidelines. These guidelines are helping make sure the internet is accessible to all people no matter how they would need to access the internet (screen-reader, keyboard only, etc) <a href=\"https:\/\/www.w3.org\/TR\/WCAG21\/\">https:\/\/www.w3.org\/TR\/WCAG21\/<\/a>.<\/span><\/span><\/span>) expectations, although it continues to be the case that WCAG does not apply directly to themes; WCAG is a measurement for content, and themes are only a wrapper for your content.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Why are the accessibility-ready requirements changing?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The original requirements were written in 2011, and added to the theme review process in 2012. This was before WCAG 2.1 or WCAG 2.2 were published, and before HTML5 or ARIA had wide support and adoption.\u00a0<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Since 2012, general awareness of accessibility has increased, and the capabilities for creating more accessible websites have also improved. It\u2019s become increasingly important for WordPress\u2019 Accessibility-ready requirements to modernize, to ensure that people implementing accessibility-ready themes are getting the best experiences.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Where can I find the new accessibility-ready requirements?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The theme review guidelines have been updated and are listed in the <a href=\"https:\/\/make.wordpress.org\/themes\/handbook\/review\/accessibility\/required\/\">Accessibility section of the theme review handbook<\/a>. The topics are currently being maintained on the <a href=\"https:\/\/wpaccessibility.org\">Accessibility Team\u2019s documentation site<\/a>. On that site, you can also find extensive guidance on all of the accessibility issues raised by the theme review requirements.\u00a0<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What has changed?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">You should read the requirements for full details on what has changed. At a high level, here is a summary of changes:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Guidelines for themes have been updated to only include requirements, and \u201crecommendations\u201d have been removed. Some recommendations have been made requirements; other recommendations have been removed as they are best practices and not blockers to receiving accessibility-ready tag approval.<\/li>\n\n\n\n<li>Requirement titles have been rewritten to clearly summarize the expectation.<\/li>\n\n\n\n<li>All guidelines now follow a standard format with the following sections:\n<ul class=\"wp-block-list\">\n<li>Basic principle: explains what the requirement is and why it matters.<\/li>\n\n\n\n<li>Testing: includes a list of tools needed for the testing process and detailed, numbered, step-by-step explanations on how to test the requirement, with clear pass\/fail criteria at each step.<\/li>\n\n\n\n<li>WCAG resources: links to relevant WCAG docs that apply to our requirement, for people who want to learn more.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>A standard process has been established for documenting testing in a Google Sheet, with a copyable template. The aim of this process is to make it easier for anyone to test, even without prior accessibility knowledge, and to ensure that theme developers receive consistent feedback, regardless of who tests their theme.<\/li>\n\n\n\n<li>Some new requirements have been added:\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/wpaccessibility.org\/docs\/topics\/theme-guidelines\/reflow-resize\/\">Support for reflow, resize, and text spacing changes<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/wpaccessibility.org\/docs\/topics\/theme-guidelines\/unexpected-changes-of-context\/\">No unexpected changes of context<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/wpaccessibility.org\/docs\/topics\/theme-guidelines\/content-hover-focus\/\">Content on hover or focus is accessible<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/wpaccessibility.org\/docs\/topics\/theme-guidelines\/accessibility-statement\/\">Accessibility statement<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/wpaccessibility.org\/docs\/topics\/theme-guidelines\/no-inaccessible-plugins\/\">Must not recommend or require inaccessible plugins<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">How can I learn more about the requirements?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The documentation is very detailed, and covers how to test each requirement. However, to help users understand the process from the beginning, <a href=\"https:\/\/profiles.wordpress.org\/alh0319\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>alh0319<\/a> will be <a href=\"https:\/\/equalizedigital.com\/gaad2026\/\">hosting a webinar on Thursday, May 21st \u2013 Global Accessibility Awareness Day<\/a>. She\u2019ll walk through the entire process of testing a theme for accessibility-ready standards, and attendees will be able to learn by testing themes during the webinar.\u00a0<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">If enough people sign up for the webinar, the aim is to get all of the <a href=\"https:\/\/wordpress.org\/themes\/tags\/accessibility-ready\/\">current 108 accessibility-ready themes<\/a> re-tested against the new requirements. <a href=\"https:\/\/profiles.wordpress.org\/rianrietveld\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>rianrietveld<\/a> and <a href=\"https:\/\/profiles.wordpress.org\/joedolson\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>joedolson<\/a> will be available to provide support and help testers work through challenges!<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">How does this impact my live accessibility-ready theme?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">All accessibility-ready themes will be expected to update their themes to meet the new standards. Many of the requirements are essentially the same, but there are some new requirements as noted above.\u00a0<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Theme authors will have until June 30th, 2026 to get their themes updated \u2014 either to update their accessibility, or to remove the tag.\u00a0<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Read the requirements, update your theme, then please request a review when you\u2019re ready!<\/p>\n\n\n\n<div class=\"wp-block-buttons is-content-justification-center is-layout-flex wp-container-core-buttons-is-layout-36078703 wp-block-buttons-is-layout-flex\">\n<div class=\"wp-block-button\"><a class=\"wp-block-button__link wp-element-button\" href=\"https:\/\/wpaccessibility.org\/docs\/topics\/theme-guidelines\/\">Read the Requirements<\/a><\/div>\n\n\n\n<div class=\"wp-block-button\"><a class=\"wp-block-button__link wp-element-button\" href=\"https:\/\/make.wordpress.org\/accessibility\/request-an-accessibility-ready-review\/\">Request an Accessibility Review<\/a><\/div>\n<\/div>\n\n\n\n<h2 class=\"wp-block-heading\">Thanks &amp; Props<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The primary work on the new accessibility-ready guidelines was done by Amber Hinds, with assistance from Joe Dolson. However, many others have contributed to the long process of developing the requirements and the process for testing:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><em><a href=\"https:\/\/profiles.wordpress.org\/rianrietveld\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>rianrietveld<\/a><\/em><\/li>\n\n\n\n<li><em><a href=\"https:\/\/profiles.wordpress.org\/jessicagoddard\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>jessicagoddard<\/a><\/em><\/li>\n\n\n\n<li><em><a href=\"https:\/\/profiles.wordpress.org\/miriamgoldman\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>miriamgoldman<\/a><\/em><\/li>\n\n\n\n<li><em><a href=\"https:\/\/profiles.wordpress.org\/slferguson\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>slferguson<\/a><\/em><\/li>\n\n\n\n<li><em><a href=\"https:\/\/profiles.wordpress.org\/mpmike\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>mpmike<\/a><\/em><\/li>\n\n\n\n<li><em><a href=\"https:\/\/profiles.wordpress.org\/christophermhinds\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>christophermhinds<\/a><\/em><\/li>\n\n\n\n<li><em><a href=\"https:\/\/profiles.wordpress.org\/pirenko\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>pirenko<\/a><\/em><\/li>\n\n\n\n<li><em><a href=\"https:\/\/profiles.wordpress.org\/clumi\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>clumi<\/a><\/em><\/li>\n\n\n\n<li><em><a href=\"https:\/\/profiles.wordpress.org\/ryokuhi\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>Ryokuhi<\/a><\/em><\/li>\n\n\n\n<li><em><a href=\"https:\/\/profiles.wordpress.org\/nadav\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>Nadav<\/a><\/em><\/li>\n\n\n\n<li><em><a href=\"https:\/\/profiles.wordpress.org\/tehila\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>Tehila<\/a><\/em><\/li>\n\n\n\n<li><em><a href=\"https:\/\/profiles.wordpress.org\/oksankaa\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>oksankaa<\/a><\/em><\/li>\n\n\n\n<li><em><a href=\"https:\/\/profiles.wordpress.org\/akinom500\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>akinom500<\/a><\/em><\/li>\n\n\n\n<li><em><a href=\"https:\/\/profiles.wordpress.org\/stuartpyper\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>stuartpyper<\/a>\u00a0<\/em><\/li>\n\n\n\n<li><em><a href=\"https:\/\/profiles.wordpress.org\/nikunj8866\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>nikunj8866<\/a><\/em><\/li>\n\n\n\n<li><em><a href=\"https:\/\/profiles.wordpress.org\/maxelementary\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>maxelementary<\/a><\/em><\/li>\n\n\n\n<li><em><a href=\"https:\/\/profiles.wordpress.org\/mirasus\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>mirasus<\/a><\/em><\/li>\n\n\n\n<li><em><a href=\"https:\/\/profiles.wordpress.org\/vineettalwar\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>vineettalwar<\/a><\/em><\/li>\n\n\n\n<li><em>Cam Coulter<\/em><\/li>\n\n\n\n<li><em>Karim Jetha<\/em><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Did you help with this process, but don\u2019t see yourself in the list? Please comment below to let us know!<\/em><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Additional thanks are owed to <a href=\"https:\/\/instawp.com\">InstaWP<\/a>, for donating their services to mount testing sites. You may wonder why this process isn\u2019t using Playground, which is already available on <a href=\"http:\/\/wordpress.org\">WordPress.org<\/a>. Unfortunately, Playground renders inside an <span tabindex='0' class='glossary-item-container'>iframe<span class='glossary-item-hidden-content'><span class='glossary-item-header'>iframe<\/span> <span class='glossary-item-description'>iFrame is an acronym for an inline frame. An iFrame is used inside a webpage to load another HTML document and render it. This HTML document may also contain JavaScript and\/or CSS which is loaded at the time when iframe tag is parsed by the user\u2019s browser.<\/span><\/span><\/span>, which breaks a number of key testing tools used to examine the content, particularly bookmarklets. It is possible to test within Playground, but considerably more labor-intensive.\u00a0<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The goal is to make it easier for anyone to contribute to theme accessibility-ready testing using common tools, and InstaWP makes this possible.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Reviewed by <a href=\"https:\/\/profiles.wordpress.org\/alh0319\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>alh0319<\/a> and <a href=\"https:\/\/profiles.wordpress.org\/rianrietveld\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>rianrietveld<\/a>.<\/em><\/p>\n<p class=\"o2-appended-tags\"><a href=\"https:\/\/make.wordpress.org\/accessibility\/tag\/accessibility-ready\/\" class=\"tag\"><span class=\"tag-prefix\">#<\/span>accessibility-ready<\/a><\/p><nav class='o2-post-footer-actions'><ul class='o2-post-footer-action-row'><li class='o2-post-footer-action'><a href=\"https:\/\/login.wordpress.org\/?redirect_to=https%3A%2F%2Fmake.wordpress.org%2Faccessibility%2F2026%2F05%2F06%2Faccessibility-ready-requirements-updated%2F%23respond&#038;locale=en_US\" title=\"Login to Reply\"  class=\"genericon  genericon-reply\"  data-action=\"login-to-reply\"  data-actionstate=\"default\" >Login to Reply<\/a><\/li><\/ul><div class='o2-post-footer-action-likes'><\/div><ul class='o2-post-footer-action-row'><\/ul><\/nav>","protected":false},"excerpt":{"rendered":"<p>Learn about the updated WordPress Theme Requirements for the accessibility-ready tag. The new guidelines come with detailed documentation, testing instructions, and many improved processes.<\/p>\n","protected":false},"author":1248163,"featured_media":0,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[575,24],"tags":[77],"class_list":["post-17419","post","type-post","status-publish","format-standard","hentry","category-accessibility","category-themes","tag-accessibility-ready","mentions-akinom500","mentions-alh0319","mentions-christophermhinds","mentions-clumi","mentions-jessicagoddard","mentions-joedolson","mentions-maxelementary","mentions-mirasus","mentions-miriamgoldman","mentions-mpmike","mentions-nadav","mentions-nikunj8866","mentions-oksankaa","mentions-pirenko","mentions-rianrietveld","mentions-ryokuhi","mentions-slferguson","mentions-stuartpyper","mentions-tehila","mentions-vineettalwar","author-joedolson"],"revision_note":"","jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/make.wordpress.org\/accessibility\/wp-json\/wp\/v2\/posts\/17419","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/make.wordpress.org\/accessibility\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/make.wordpress.org\/accessibility\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/make.wordpress.org\/accessibility\/wp-json\/wp\/v2\/users\/1248163"}],"replies":[{"embeddable":true,"href":"https:\/\/make.wordpress.org\/accessibility\/wp-json\/wp\/v2\/comments?post=17419"}],"version-history":[{"count":9,"href":"https:\/\/make.wordpress.org\/accessibility\/wp-json\/wp\/v2\/posts\/17419\/revisions"}],"predecessor-version":[{"id":17431,"href":"https:\/\/make.wordpress.org\/accessibility\/wp-json\/wp\/v2\/posts\/17419\/revisions\/17431"}],"wp:attachment":[{"href":"https:\/\/make.wordpress.org\/accessibility\/wp-json\/wp\/v2\/media?parent=17419"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/make.wordpress.org\/accessibility\/wp-json\/wp\/v2\/categories?post=17419"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/make.wordpress.org\/accessibility\/wp-json\/wp\/v2\/tags?post=17419"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}