{"id":207,"date":"2025-09-23T04:50:31","date_gmt":"2025-09-23T11:50:31","guid":{"rendered":"https:\/\/pressbooks.palomar.edu\/guide\/chapter\/accessibility-authoring-tool\/"},"modified":"2025-11-21T12:19:13","modified_gmt":"2025-11-21T20:19:13","slug":"accessibility-authoring-tool","status":"publish","type":"chapter","link":"https:\/\/pressbooks.palomar.edu\/guide\/chapter\/accessibility-authoring-tool\/","title":{"raw":"Use the Accessibility Authoring Tool","rendered":"Use the Accessibility Authoring Tool"},"content":{"raw":"<div class=\"textbox textbox--exercises\"><header class=\"textbox__header\">\r\n<p class=\"textbox__title\">In this Chapter<\/p>\r\n\r\n<\/header>\r\n<div class=\"textbox__content\">\r\n<ul id=\"navtoc\">\r\n \t<li><a href=\"#alerts\">View Alerts<\/a><\/li>\r\n \t<li><a href=\"#hide\">Show \/ Hide Alerts in the Editor<\/a><\/li>\r\n \t<li><a href=\"#reports\">Access Book-Level Reports<\/a><\/li>\r\n \t<li><a href=\"#video-use-editoria11y\">Video: Use Editoria11y<\/a><\/li>\r\n<\/ul>\r\n<\/div>\r\n<\/div>\r\nThe <strong>Pressbooks Accessibility Authoring Tool <\/strong>is powered by <strong>Editoria11y<\/strong>. This tool helps you spot and resolve accessibility issues while you create or edit content in Pressbooks. You can view flagged issues directly in the editor, make changes, and track improvements over time.\r\n\r\nWhen activated, you\u2019ll see the Pressbooks Accessibility Authoring Tool automatically when working on your books. If you don\u2019t see it and would like access, please <a href=\"https:\/\/atrchelp.palomar.edu\/\">contact Palomar College ATRC<\/a>.\r\n\r\nIn this chapter, we'll describe how to use the Accessibility Authoring Tool. For more information on ensuring your book's accessibility, please see <a href=\"\/chapter\/accessibility\/\">our guide chapter on the topic<\/a>.\r\n<h1><a id=\"alerts\"><\/a>View Alerts<\/h1>\r\nAs a logged-in user with the <a href=\"\/chapter\/users\/\">book user role<\/a> of author, editor, collaborator, or administrator, the Accessibility Authoring Tool will automatically check your content in the <a href=\"\/chapter\/edit-content-with-the-visual-text-editors\/\">Visual editor<\/a> as well as on any rendered webbook page, flagging common accessibility issues which can be addressed from the editor.\r\n\r\nThe tool checks for page structure that is meaningful for screen readers and search engines; text alternatives for images and media; meaningful links; and other, miscellaneous accessibility issues. (Please note that it does not flag design issues with color contrast.)\r\n\r\n<span style=\"text-align: initial; font-size: 1em;\">Each flagged issue, or <\/span><strong style=\"text-align: initial; font-size: 1em;\">alert<\/strong><span style=\"text-align: initial; font-size: 1em;\">, is marked with a tooltip.<\/span>\r\n\r\n<span style=\"text-align: initial; font-size: 1em;\"><img class=\"alignnone wp-image-1282\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2025\/09\/exclamation-mark.png\" alt=\"A screenshot of the exclamation mark tooltip.\" width=\"76\" height=\"66\" \/> <\/span><span style=\"text-align: initial; font-size: 1em;\">Unambiguous issues are marked in red, with an exclamation mark in a circle.<\/span>\r\n\r\n<span style=\"text-align: initial; font-size: 1em;\"><img class=\"alignnone wp-image-1281\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2025\/09\/question-mark.png\" alt=\"A screenshot of the question mark tooltip.\" width=\"76\" height=\"66\" \/> Dismissible tips are marked in yellow, with a question mark in a circle.<\/span>\r\n\r\n<span style=\"text-align: initial; font-size: 1em;\">Hovering your cursor over the alert tooltip -- or using the tab key to navigate from one issue to the next, pressing the enter key while the tooltip is selected -- opens a pop-up with a text description, providing instant feedback on the issue and how to resolve it.<\/span>\r\n\r\nA small <strong>control panel<\/strong> also appears in the bottom-right corner of the screen on every webbook page (and its corresponding Visual editor).\r\n\r\n<img class=\"alignnone wp-image-1244 size-full\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2025\/09\/Control-Panel.png\" alt=\"A screenshot of the control panel for the accessibility tool.\" width=\"322\" height=\"116\" \/>\r\n\r\nWithin this control panel, the \"Show \/ hide accessibility alerts\" button allows you to toggle between showing or hiding alert tooltips as you view the page. The button on the furthest right with a number or an arrow, \"Go to first \/ next alert,\" allows you to jump to the next alert tooltip on the page.\r\n\r\nLearn more about how to fix common accessibility issues in our chapter \"<a href=\"\/chapter\/accessibility\/\">Ensure Your Book's Accessibility<\/a>\".\r\n<h1><a id=\"hide\"><\/a>Show \/ Hide Alerts in the Editor<\/h1>\r\nAs you're working in the Visual editor, there are times when you may not want to view accessibility alerts. To hide all alerts from editor, click the flag button in the control panel in the bottom-right corner of the Edit page:\r\n\r\n<img class=\"alignnone wp-image-1244 size-full\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2025\/09\/Control-Panel.png\" alt=\"A screenshot of the control panel for the accessibility tool.\" width=\"322\" height=\"116\" \/>\r\n\r\nTo show all alerts again, click the flag button again. Alerts are shown by default when loading the Edit page but they can always be toggled on and off this way.\r\n\r\nAdditionally, if you have the role of Administrator in a book, you have the option of entirely disabling accessibility alerts in the Visual editor throughout the book. If you'd like to do this, navigate to <strong>Settings &gt; Editoria11y\u00a0<\/strong>in the left sidebar of your book dashboard. Under Basic Configuration, set \"Check while editing content\" to \"Do not check while editing\" and save changes. You can update this setting in the future if you'd like to restore accessibility alerts to the Visual editor.\r\n<h1><a id=\"reports\"><\/a>Access Book-Level Reports<\/h1>\r\nIf you have the user role of Editor or Administrator within a book, you can also view a report on issues identified throughout the book. This report is reachable from the <strong>Editoria11y\u00a0<\/strong>link in the left sidebar of the book dashboard (or from the aforementioned control panel on any Visual editor or webbook page, via the \"Open site reports in new tab\" button).\r\n\r\nThis <strong>book-level report<\/strong> includes:\r\n<ul>\r\n \t<li>recent issues<\/li>\r\n \t<li>a summary of issues by page (sorted by which pages have the most issues)<\/li>\r\n \t<li>an overview of issue types (sorted by prevalence)<\/li>\r\n \t<li>recent issue dismissals<\/li>\r\n<\/ul>\r\nThis report can also be downloaded as a CSV.\r\n<h1><a id=\"video-use-editoria11y\"><\/a>Video: Use Editoria11y<\/h1>\r\nhttps:\/\/www.youtube.com\/watch?v=JyTC98qlC_w","rendered":"<div class=\"textbox textbox--exercises\">\n<header class=\"textbox__header\">\n<p class=\"textbox__title\">In this Chapter<\/p>\n<\/header>\n<div class=\"textbox__content\">\n<ul id=\"navtoc\">\n<li><a href=\"#alerts\">View Alerts<\/a><\/li>\n<li><a href=\"#hide\">Show \/ Hide Alerts in the Editor<\/a><\/li>\n<li><a href=\"#reports\">Access Book-Level Reports<\/a><\/li>\n<li><a href=\"#video-use-editoria11y\">Video: Use Editoria11y<\/a><\/li>\n<\/ul>\n<\/div>\n<\/div>\n<p>The <strong>Pressbooks Accessibility Authoring Tool <\/strong>is powered by <strong>Editoria11y<\/strong>. This tool helps you spot and resolve accessibility issues while you create or edit content in Pressbooks. You can view flagged issues directly in the editor, make changes, and track improvements over time.<\/p>\n<p>When activated, you\u2019ll see the Pressbooks Accessibility Authoring Tool automatically when working on your books. If you don\u2019t see it and would like access, please <a href=\"https:\/\/atrchelp.palomar.edu\/\">contact Palomar College ATRC<\/a>.<\/p>\n<p>In this chapter, we&#8217;ll describe how to use the Accessibility Authoring Tool. For more information on ensuring your book&#8217;s accessibility, please see <a href=\"\/chapter\/accessibility\/\">our guide chapter on the topic<\/a>.<\/p>\n<h1><a id=\"alerts\"><\/a>View Alerts<\/h1>\n<p>As a logged-in user with the <a href=\"\/chapter\/users\/\">book user role<\/a> of author, editor, collaborator, or administrator, the Accessibility Authoring Tool will automatically check your content in the <a href=\"\/chapter\/edit-content-with-the-visual-text-editors\/\">Visual editor<\/a> as well as on any rendered webbook page, flagging common accessibility issues which can be addressed from the editor.<\/p>\n<p>The tool checks for page structure that is meaningful for screen readers and search engines; text alternatives for images and media; meaningful links; and other, miscellaneous accessibility issues. (Please note that it does not flag design issues with color contrast.)<\/p>\n<p><span style=\"text-align: initial; font-size: 1em;\">Each flagged issue, or <\/span><strong style=\"text-align: initial; font-size: 1em;\">alert<\/strong><span style=\"text-align: initial; font-size: 1em;\">, is marked with a tooltip.<\/span><\/p>\n<p><span style=\"text-align: initial; font-size: 1em;\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-1282\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2025\/09\/exclamation-mark.png\" alt=\"A screenshot of the exclamation mark tooltip.\" width=\"76\" height=\"66\" \/> <\/span><span style=\"text-align: initial; font-size: 1em;\">Unambiguous issues are marked in red, with an exclamation mark in a circle.<\/span><\/p>\n<p><span style=\"text-align: initial; font-size: 1em;\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-1281\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2025\/09\/question-mark.png\" alt=\"A screenshot of the question mark tooltip.\" width=\"76\" height=\"66\" \/> Dismissible tips are marked in yellow, with a question mark in a circle.<\/span><\/p>\n<p><span style=\"text-align: initial; font-size: 1em;\">Hovering your cursor over the alert tooltip &#8212; or using the tab key to navigate from one issue to the next, pressing the enter key while the tooltip is selected &#8212; opens a pop-up with a text description, providing instant feedback on the issue and how to resolve it.<\/span><\/p>\n<p>A small <strong>control panel<\/strong> also appears in the bottom-right corner of the screen on every webbook page (and its corresponding Visual editor).<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-1244 size-full\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2025\/09\/Control-Panel.png\" alt=\"A screenshot of the control panel for the accessibility tool.\" width=\"322\" height=\"116\" \/><\/p>\n<p>Within this control panel, the &#8220;Show \/ hide accessibility alerts&#8221; button allows you to toggle between showing or hiding alert tooltips as you view the page. The button on the furthest right with a number or an arrow, &#8220;Go to first \/ next alert,&#8221; allows you to jump to the next alert tooltip on the page.<\/p>\n<p>Learn more about how to fix common accessibility issues in our chapter &#8220;<a href=\"\/chapter\/accessibility\/\">Ensure Your Book&#8217;s Accessibility<\/a>&#8220;.<\/p>\n<h1><a id=\"hide\"><\/a>Show \/ Hide Alerts in the Editor<\/h1>\n<p>As you&#8217;re working in the Visual editor, there are times when you may not want to view accessibility alerts. To hide all alerts from editor, click the flag button in the control panel in the bottom-right corner of the Edit page:<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-1244 size-full\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2025\/09\/Control-Panel.png\" alt=\"A screenshot of the control panel for the accessibility tool.\" width=\"322\" height=\"116\" \/><\/p>\n<p>To show all alerts again, click the flag button again. Alerts are shown by default when loading the Edit page but they can always be toggled on and off this way.<\/p>\n<p>Additionally, if you have the role of Administrator in a book, you have the option of entirely disabling accessibility alerts in the Visual editor throughout the book. If you&#8217;d like to do this, navigate to <strong>Settings &gt; Editoria11y\u00a0<\/strong>in the left sidebar of your book dashboard. Under Basic Configuration, set &#8220;Check while editing content&#8221; to &#8220;Do not check while editing&#8221; and save changes. You can update this setting in the future if you&#8217;d like to restore accessibility alerts to the Visual editor.<\/p>\n<h1><a id=\"reports\"><\/a>Access Book-Level Reports<\/h1>\n<p>If you have the user role of Editor or Administrator within a book, you can also view a report on issues identified throughout the book. This report is reachable from the <strong>Editoria11y\u00a0<\/strong>link in the left sidebar of the book dashboard (or from the aforementioned control panel on any Visual editor or webbook page, via the &#8220;Open site reports in new tab&#8221; button).<\/p>\n<p>This <strong>book-level report<\/strong> includes:<\/p>\n<ul>\n<li>recent issues<\/li>\n<li>a summary of issues by page (sorted by which pages have the most issues)<\/li>\n<li>an overview of issue types (sorted by prevalence)<\/li>\n<li>recent issue dismissals<\/li>\n<\/ul>\n<p>This report can also be downloaded as a CSV.<\/p>\n<h1><a id=\"video-use-editoria11y\"><\/a>Video: Use Editoria11y<\/h1>\n<p><iframe loading=\"lazy\" id=\"oembed-1\" title=\"Using Editoria11y in Pressbooks\" width=\"500\" height=\"281\" src=\"https:\/\/www.youtube.com\/embed\/JyTC98qlC_w?feature=oembed&#38;rel=0\" frameborder=\"0\" allowfullscreen=\"allowfullscreen\"><\/iframe><\/p>\n","protected":false},"author":2,"menu_order":29,"template":"","meta":{"pb_show_title":"on","pb_short_title":"","pb_subtitle":"","pb_authors":[],"pb_section_license":"cc-by"},"chapter-type":[],"contributor":[],"license":[53],"class_list":["post-207","chapter","type-chapter","status-publish","hentry","license-cc-by"],"part":53,"_links":{"self":[{"href":"https:\/\/pressbooks.palomar.edu\/guide\/wp-json\/pressbooks\/v2\/chapters\/207","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pressbooks.palomar.edu\/guide\/wp-json\/pressbooks\/v2\/chapters"}],"about":[{"href":"https:\/\/pressbooks.palomar.edu\/guide\/wp-json\/wp\/v2\/types\/chapter"}],"author":[{"embeddable":true,"href":"https:\/\/pressbooks.palomar.edu\/guide\/wp-json\/wp\/v2\/users\/2"}],"version-history":[{"count":6,"href":"https:\/\/pressbooks.palomar.edu\/guide\/wp-json\/pressbooks\/v2\/chapters\/207\/revisions"}],"predecessor-version":[{"id":226,"href":"https:\/\/pressbooks.palomar.edu\/guide\/wp-json\/pressbooks\/v2\/chapters\/207\/revisions\/226"}],"part":[{"href":"https:\/\/pressbooks.palomar.edu\/guide\/wp-json\/pressbooks\/v2\/parts\/53"}],"metadata":[{"href":"https:\/\/pressbooks.palomar.edu\/guide\/wp-json\/pressbooks\/v2\/chapters\/207\/metadata\/"}],"wp:attachment":[{"href":"https:\/\/pressbooks.palomar.edu\/guide\/wp-json\/wp\/v2\/media?parent=207"}],"wp:term":[{"taxonomy":"chapter-type","embeddable":true,"href":"https:\/\/pressbooks.palomar.edu\/guide\/wp-json\/pressbooks\/v2\/chapter-type?post=207"},{"taxonomy":"contributor","embeddable":true,"href":"https:\/\/pressbooks.palomar.edu\/guide\/wp-json\/wp\/v2\/contributor?post=207"},{"taxonomy":"license","embeddable":true,"href":"https:\/\/pressbooks.palomar.edu\/guide\/wp-json\/wp\/v2\/license?post=207"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}