{"id":17516,"date":"2026-06-30T07:29:35","date_gmt":"2026-06-30T07:29:35","guid":{"rendered":"https:\/\/make.wordpress.org\/accessibility\/?p=17516"},"modified":"2026-06-30T07:29:35","modified_gmt":"2026-06-30T07:29:35","slug":"wp-a11y-docs-update-june-2026","status":"publish","type":"post","link":"https:\/\/make.wordpress.org\/accessibility\/2026\/06\/30\/wp-a11y-docs-update-june-2026\/","title":{"rendered":"WP A11y Docs update June 2026"},"content":{"rendered":"<p class=\"wp-block-paragraph\">With: the feedback we received on the <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 requirements and the knowledge base during <span tabindex='0' class='glossary-item-container'>Contributor day<span class='glossary-item-hidden-content'><span class='glossary-item-header'>Contributor Day<\/span> <span class='glossary-item-description'>Contributor Days are standalone days, frequently held before or after WordCamps but they can also happen at any time. They are events where people get together to work on various areas of <a href=\"https:\/\/make.wordpress.org\/\">https:\/\/make.wordpress.org\/<\/a> There are many teams that people can participate in, each with a different focus. <a href=\"https:\/\/make.wordpress.org\/support\/handbook\/getting-started\/getting-started-at-a-contributor-day\/\">https:\/\/make.wordpress.org\/support\/handbook\/getting-started\/getting-started-at-a-contributor-day\/<\/a><\/span><\/span><\/span> at <span tabindex='0' class='glossary-item-container'>WordCamp<span class='glossary-item-hidden-content'><span class='glossary-item-header'>WordCamp<\/span> <span class='glossary-item-description'>WordCamps are casual, locally-organized conferences covering everything related to WordPress. They're one of the places where the WordPress community comes together to teach one another what they\u2019ve learned throughout the year and share the joy. <a href=\"https:\/\/central.wordcamp.org\/about\/\">Learn more<\/a>.<\/span><\/span><\/span> Europe, as well as the work we did to process that feedback.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Read the recap of the <a href=\"https:\/\/make.wordpress.org\/accessibility\/2026\/06\/19\/a11y-at-wordcamp-europe-26-in-krakow\/\">Accessibility Team\u2019s work at WordCamp Europe 2026<\/a> for more details.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">During the contributor day of WordCamp Europe, people at one table tested themes for the accessibility-ready tag. This gave us an excellent opportunity to see if the knowledge base works. We got <a href=\"https:\/\/github.com\/wpaccessibility\/wp-a11y-docs\/issues\/346\">useful feedback<\/a> and the rest of the month we worked on processing this.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">All the documentation for the accessibility-ready tag is now renamed <a href=\"https:\/\/wpaccessibility.org\/docs\/accessibility-ready\/\">Accessibility-ready program<\/a> and is placed under one main menu item. Now the information is easier to discover and it gives us room to add more related documentation to this section. Some URLs have changed, we tried to catch all links but if you discover a still broken <span tabindex='0' class='glossary-item-container'>URL<span class='glossary-item-hidden-content'><span class='glossary-item-header'>URL<\/span> <span class='glossary-item-description'>A specific web address of a website or web page on the Internet, such as a website\u2019s URL www.wordpress.org<\/span><\/span><\/span>, <a href=\"https:\/\/wpaccessibility.org\/docs\/about\/contact\/\">please let us know<\/a>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Important feedback was: We need to enhance accessibility-ready guidelines with classic vs. <span tabindex='0' class='glossary-item-container'>block<span class='glossary-item-hidden-content'><span class='glossary-item-header'>Block<\/span> <span class='glossary-item-description'>Block is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience.<\/span><\/span><\/span> theme information and examples how to achieve the guidelines. More info about this in [i<a href=\"https:\/\/github.com\/wpaccessibility\/wp-a11y-docs\/issues\/332\">ssue #332<\/a>].<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The \u201cLast updated\u201d date now works thanks to <a href=\"https:\/\/profiles.wordpress.org\/joedolson\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>joedolson<\/a>. So for example on <a href=\"https:\/\/wpaccessibility.org\/docs\/topics\/content\/headings\/\">Using headings in the content<\/a>, the <strong>Last updated: May 22, 2026<\/strong>, at the bottom of the content with the <span tabindex='0' class='glossary-item-container'>meta<span class='glossary-item-hidden-content'><span class='glossary-item-header'>Meta<\/span> <span class='glossary-item-description'>Meta is a term that refers to the inside workings of a group. For us, this is the team that works on internal WordPress sites like WordCamp Central and Make WordPress.<\/span><\/span><\/span> data, is now correct.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Rian hopes to update and finish the documentation about how to test for accessibility in July.<\/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>, <a href=\"https:\/\/make.wordpress.org\/accessibility\/tag\/wp-a11y-docs\/\" class=\"tag\"><span class=\"tag-prefix\">#<\/span>wp-a11y-docs<\/a><\/p><nav class='o2-post-footer-actions'><ul class='o2-post-footer-action-row'><\/ul><div class='o2-post-footer-action-likes'><\/div><ul class='o2-post-footer-action-row'><\/ul><\/nav>","protected":false},"excerpt":{"rendered":"<p>With: the feedback we received on the accessibility-ready requirements and the knowledge base during Contributor day at WordCamp Europe, as well as the work we did to process that feedback.<\/p>\n","protected":false},"author":3148028,"featured_media":0,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_post_was_ever_published":false},"categories":[575,654,567],"tags":[77,833],"class_list":["post-17516","post","type-post","status-publish","format-standard","hentry","category-accessibility","category-contributor-day","category-documentation","tag-accessibility-ready","tag-wp-a11y-docs","mentions-joedolson","author-rianrietveld"],"revision_note":"","jetpack_sharing_enabled":true,"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/make.wordpress.org\/accessibility\/wp-json\/wp\/v2\/posts\/17516","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\/3148028"}],"replies":[{"embeddable":true,"href":"https:\/\/make.wordpress.org\/accessibility\/wp-json\/wp\/v2\/comments?post=17516"}],"version-history":[{"count":4,"href":"https:\/\/make.wordpress.org\/accessibility\/wp-json\/wp\/v2\/posts\/17516\/revisions"}],"predecessor-version":[{"id":17521,"href":"https:\/\/make.wordpress.org\/accessibility\/wp-json\/wp\/v2\/posts\/17516\/revisions\/17521"}],"wp:attachment":[{"href":"https:\/\/make.wordpress.org\/accessibility\/wp-json\/wp\/v2\/media?parent=17516"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/make.wordpress.org\/accessibility\/wp-json\/wp\/v2\/categories?post=17516"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/make.wordpress.org\/accessibility\/wp-json\/wp\/v2\/tags?post=17516"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}