How to use the Accessibility feature | Acquia Product Documentation
How to use the Accessibility feature
Introduction
This page provides instructions on how to navigate the Accessibility dashboard and how to find and repair accessibility issues.
Accessibility dashboard
The Accessibility dashboard provides information on how to navigate and edit website accessibility issues and shows the selected level of compliance and the WCAG compliance for the selected target level and all of the lower levels.
To reach the Accessibility dashboard, click Accessibility (icon of a human with arms outstretched) on the page toolbar. The Accessibility dashboard opens.
Accessibility diagnostics
This section of the Accessibility dashboard shows the percentage of the site that is compliant with the accessibility level set up for your website, as well as the industry-wide average compliance score.
Compliance score
This figure shows the percentage of the website that is compliant with the target compliance level, as selected during scan setup.
Industry average
This figure shows the industry-wide average of accessibility compliance. The results appear in the Accessibility Diagnostics section.
The left menu on the Accessibility page provides more details about the specific categories.
Summary (default view)
Select this option from the menu on the left side of the page. This section provides information about the overview of the Accessibility scan results:
Level A Compliance: Level A Compliance: This section shows the total number of checks, the total number that is done, and the total number that are not repaired. It also shows the historical results from the last 5 scans and a percentage of compliance.
Level AA Compliance: This section shows the total number of checks, the total number of repaired issues, and the total number of issues that are not repaired. It also shows the historical results from the last 5 scans and a percentage of compliance.
Accessibility checks compliance by level: This section shows the total number of completed checks at each level and those checks where repair is necessary.
Accessibility Diagnostics: This section shows the percentage level of compliance and the website industry average for accessibility issues.
Click Showing All on the top right of the section to filter for:
Show All
Only Errors
Errors and Warnings (recommended).
Accessibility Compliance: This figure shows the percentage of accessibility issues that your website has met the compliance criteria for. The goal is 100% compliance within the accessibility level selected.
Industry Average: This graph gives information about how your website compliance score compares with the average of competitors in your industry. For more information, visit Industry average.
Timeline: The graph shows the total number of quality assurance issues and the total number of pages that have issues over time.
Show History: Click this button to see the results from all scans.
PDF Compliance Status: This page shows an overview of PDF accessibility scan results and the total number of reviewed or pending files. For more information, visit PDF accessibility scan.
Fast Track
Select this option from the menu on the left side of the page. This section provides instructions on how to navigate the data and how to use Fast Track to review, repair, and ignore HTML snippets in bulk.
Select this option from the menu on the left side of the page. This page shows a list of all checks that need action, sorted by page. This section provides instructions on how to navigate the information provided and how to use this view to review, repair, and ignore issues.
The Pages with Failing Checks page opens. The list shows the URLs for pages that have accessibility issues.
Filter the list or sort for labels.
Sort between:
All Levels
Level A
Level AA
Level AAA.
The table column headers are:
Title and URL: This column shows the page title and the URL. Click the link to navigate to the detailed scan results for the page.
Labels: This column shows the labels for the domain.
Failing Checks: This column shows the number of Accessibility checks that failed the check on the page. Click the number to see details about the failed checks.
Page Compliance: This column shows the percentage of the page that is compliant with the selected accessibility level. The page compliance is also shown in a donut chart format.
Priority: This column shows the level of priority that the page has. High, Medium, or Low.
Views: This column shows the number of views that the page had since the last scan.
Open Page Details (the page icon): On the same row as a page with failing checks, click to open the page details.
The Page Details page opens. This page shows accessibility checks with issues and the percentage of compliance for the webpage.
Depending upon the level of compliance that is selected, the following information is shown:
Filter (the filter icon): Click the button to filter the list for:
Labels
Languages
Accessibility Level
Accessibility Error Type.
The issues are listed on the left side of the page. Click on an issue to see the details about the issue and suggestions for how to fix it. Use the button (graduation cap icon) to navigate to the and read more about the error and how to fix it.
Checklist (insect icon)
Select this option from the menu on the left side of the page. This page shows a list of all checks that need action, sorted by priority:
Issues to Fix: Errors must be fixed for compliance.
Warnings: Warnings are likely to be issues, but they require manual investigation.
Reviews: Reviews require manual judgement.
Select the compliance level to filter for:
Level A
Level AA
Level AAA
Ignored
Passed.
The results are displayed in a table with the following headers:
Check: This column shows the name and description of the check that is done.
Responsibility: This column shows the designated team or teams that are normally responsible for fixing this type of error. This column is automatically filled in. The areas of responsibility are:
UX Design
Front end development
Content authoring
Visual design.
Success Criteria: This column shows a list of the compliance success criteria category.
Help Center: Click to navigate to the Accessibility Guide for more details about the issue and some suggestions on how to fix it. For more information, visit About the Accessibility Guide.
Action Button: This column contains an Action button for each list item. Click the button on the same row as an issue for more options:
Ignore this check: Issues that are set to Ignore are permanently omitted from future scans and compliance scores.
Domain Compliance: This column shows the percentage of compliance on this domain.
Pages: This column lists the number of pages that have the error. Click to navigate to the error page to view:
The URL for all of the pages where the error occurs.
Suggestions on how to fix the issue.
Guidelines
Select this option from the menu on the left side of the page. This page is a list of the most basic WCAG guidelines that the scan locates and identifies, which do not meet the requirements. This section provides instructions on how to navigate the data and how to use the findings to repair issues.
The results are shown on this page in a table with the following headers:
Name and category of the guideline
Error: This column shows the errors from the most recent scan. Click the bug icon. The List of Accessibility Issues page opens. The issues are shown in a table format. The columns are:
Title and URL: This column shows a list of the page title and URL where the error is. Click the link to navigate to the detailed scan results for the page.
Labels: This column shows the labels for the domain.
For more information and instructions for admin users on how to create labels, visit Create and apply labels.
Priority: This column shows the level of priority that the page has. Priority is High, Medium, or Low.
Views: This column shows the number of views for the page since the last scan.
Each row has the additional options to:
Open page details (the page icon): Click to view the page dashboard. The Accessibility Page Details page opens. Depending upon the level of compliance that is selected, the following information is displayed.
The issues are listed on the left side of the page. Select an issue to view the details about the issue and some suggestions on how to fix it.
Fix the issue from the right side of the page.
Review All Issues
IgnoreCheck: Use this option:
If the issue is incorrectly marked as broken.
To ignore issues on a single-page basis.
To ignore all other issues on a domain level.
Inspect Page with Browser Extension (magnifying glass icon): Click to navigate to the page URL and view the page with the web browser extension.
: If it is installed, use the web browser extension to identify the placement of the errors on the page, repair the errors, and more.
Select this option from the menu on the left side of the page. This page shows a list of all of your website pages that contain ignored checks. This section provides instructions on how to navigate through the data and handle ignored checks.
The column headers are:
Title and URL: Lists the page title and the URL. Click the link to navigate to the detailed scan results for the page.
Click a page link to navigate to the WCAG Accessibility Compliance detail view for the page.
The list headers are:
Checks: Lists the WCAG compliance check, as well as the team that normally is responsible for fixing issues and the criteria identifier.
Individual issues: Shows the number of unique issues found with the check.
Click to select an issue. The pane on the right-hand side of the page updates to show actions that can be made to the issue.
Sort for:
Pending to view pending actions.
Ignored to view ignored issues.
Review all issues: Click to review all issues. A dialog opens. Fill in a free-text reason and then click OK.
Ignore check: Click to ignore the check. A dialog opens. Fill in a free-text reason and then click OK.
Mark check as fixed: Click to mark the check as fixed. A dialog opens. Click OK to mark the check as Fixed.
Note
The difference between Mark as Fixed and is that issues that you mark as are still included in future scans and can be flagged again if the error comes back. Issues that you mark as are permanently removed from future scans and all compliance scores.
Each row has the additional options to:
Open page details (the page icon): Click to view the page dashboard. The Accessibility Page Details window slides open. Depending upon the level of compliance that is selected, the following information is displayed:
The issues are listed on the left side of the page.
Issue list: Click to highlight an issue. On the right side of the page, the details about the issue and some suggestions on how to fix it are shown.
Fix the issue from the right side of the page.
Review All Issues
IgnoreCheck: Use this option:
If the issue is incorrectly marked as broken.
To ignore issues on a single-page basis.
To ignore all other issues on a domain level.
Inspect Page with Browser Extension (magnifying glass icon): Click to navigate to the page URL and view the page with the web browser extension.
Tip: If it is installed, use the web browser extensionto identify the placement of the errors on the page, repair the errors, and more.
This section gives instructions on how to remove a reviewed issue. Do these steps in the Audit Log section.
This procedure is for issues marked as Reviewed in the Accessibility Fast Track module or through the Page Details view. The Undo a Check Review option returns the issue to the errors view on the page and module where it occurs.
Click Audit Log from the menu on the left side of the page.
On the same row as a reviewed issue, click Action.
The Action menu expands with the following options:
Show Details
Undo Check Review.
Select Undo Check Review.
The issue is gone from the audit log and returns to the errors view on the page and module where it occurs.
If you change the accessibility level, the existing Accessibility Score scan information is erased and the new standard starts over from the beginning with the next scan. All of the history is lost. It is advised to activate a new level only when you are ready to make the updates needed, or if it becomes a legal requirement for your location and organization. If you enable the option to Exclude checks that require manual review, you might not see other potential accessibility violations on your website.
It is not recommended to require Level AAA conformance s a general policy for entire sites because it is not possible to satisfy all Level AAA Success Criteria for some content.
Level AA of WCAG 2.1 is the legal requirement to be considered accessible. WCAG 2.2 is newly released and will soon be the standard, taking over from WCAG 2.1.
When you switch to a different guideline, the compliance score can show a sudden change. A dashed line on the graph shows when the update was done and indicates the old value and the new value of the compliance score. This appears on the first scan after the guideline update.
The orange annotation appears on the compliance chart in the Accessibility module and the Accessibility section of the History Center.
The Accessibility guide provides guidelines on WCAG 2.0 and some common 2.1 requirements.
To navigate to the accessibility guide and view all of the available articles, visit Accessibility guide.
For instructions on how to access the Accessibility guide from within the platform interface and be directed to the article that is relevant to a specific error, visit About the Accessibility guide.
On the same row as an error, from the Check List page, the Page View, or the Accessibility Fast Track page, click Help Center (graduation cap icon).
Checklist view
Accessibility Fast Track view
History Center
The History Center stores all accessibility issues and details from previous scans.
The compliance score for the accessibility checks is calculated by using 100 (a perfect score) minus the number of errors found. This is then divided by the total number of accessibility checks.
For example: If the compliance for individual accessibility checks is calculated by the
total number of pages minus pages with issues
for the
check total number of pages multiplied by 100
It will make no difference if there are 10 or 10.000 issues, it calculates the number of pages that fail the check as opposed to the total number of pages.
Accessibility reports
This section provides information about the different accessibility reports that are available.
The available reports for the Accessibility feature are:
Accessibility Summary Report
Accessibility Checks Report
Pages with Accessibility Issues Report
Classic Accessibility Report
Accessibility Guidelines Report
PDF Review Report
Click Schedule This Report (calendar icon) on the same row as the report to receive the report as an email attachment. Multiple selection is allowed.
Click Open Report (eye icon) to get the newest report.
Click Report Administration (gear icon) to add other users to receive the report.
This page provides instructions on how to navigate the Accessibility dashboard and how to find and repair accessibility issues.
Accessibility dashboard
The Accessibility dashboard provides information on how to navigate and edit website accessibility issues and shows the selected level of compliance and the WCAG compliance for the selected target level and all of the lower levels.
To reach the Accessibility dashboard, click Accessibility (icon of a human with arms outstretched) on the page toolbar. The Accessibility dashboard opens.
Accessibility diagnostics
This section of the Accessibility dashboard shows the percentage of the site that is compliant with the accessibility level set up for your website, as well as the industry-wide average compliance score.
Compliance score
This figure shows the percentage of the website that is compliant with the target compliance level, as selected during scan setup.
Industry average
This figure shows the industry-wide average of accessibility compliance. The results appear in the Accessibility Diagnostics section.
The left menu on the Accessibility page provides more details about the specific categories.
Summary (default view)
Select this option from the menu on the left side of the page. This section provides information about the overview of the Accessibility scan results:
Level A Compliance: Level A Compliance: This section shows the total number of checks, the total number that is done, and the total number that are not repaired. It also shows the historical results from the last 5 scans and a percentage of compliance.
Level AA Compliance: This section shows the total number of checks, the total number of repaired issues, and the total number of issues that are not repaired. It also shows the historical results from the last 5 scans and a percentage of compliance.
Accessibility checks compliance by level: This section shows the total number of completed checks at each level and those checks where repair is necessary.
Accessibility Diagnostics: This section shows the percentage level of compliance and the website industry average for accessibility issues.
Click Showing All on the top right of the section to filter for:
Show All
Only Errors
Errors and Warnings (recommended).
Accessibility Compliance: This figure shows the percentage of accessibility issues that your website has met the compliance criteria for. The goal is 100% compliance within the accessibility level selected.
Industry Average: This graph gives information about how your website compliance score compares with the average of competitors in your industry. For more information, visit Industry average.
Timeline: The graph shows the total number of quality assurance issues and the total number of pages that have issues over time.
Show History: Click this button to see the results from all scans.
PDF Compliance Status: This page shows an overview of PDF accessibility scan results and the total number of reviewed or pending files. For more information, visit PDF accessibility scan.
Fast Track
Select this option from the menu on the left side of the page. This section provides instructions on how to navigate the data and how to use Fast Track to review, repair, and ignore HTML snippets in bulk.
Select this option from the menu on the left side of the page. This page shows a list of all checks that need action, sorted by page. This section provides instructions on how to navigate the information provided and how to use this view to review, repair, and ignore issues.
The Pages with Failing Checks page opens. The list shows the URLs for pages that have accessibility issues.
Filter the list or sort for labels.
Sort between:
All Levels
Level A
Level AA
Level AAA.
The table column headers are:
Title and URL: This column shows the page title and the URL. Click the link to navigate to the detailed scan results for the page.
Labels: This column shows the labels for the domain.
Failing Checks: This column shows the number of Accessibility checks that failed the check on the page. Click the number to see details about the failed checks.
Page Compliance: This column shows the percentage of the page that is compliant with the selected accessibility level. The page compliance is also shown in a donut chart format.
Priority: This column shows the level of priority that the page has. High, Medium, or Low.
Views: This column shows the number of views that the page had since the last scan.
Open Page Details (the page icon): On the same row as a page with failing checks, click to open the page details.
The Page Details page opens. This page shows accessibility checks with issues and the percentage of compliance for the webpage.
Depending upon the level of compliance that is selected, the following information is shown:
Filter (the filter icon): Click the button to filter the list for:
Labels
Languages
Accessibility Level
Accessibility Error Type.
The issues are listed on the left side of the page. Click on an issue to see the details about the issue and suggestions for how to fix it. Use the button (graduation cap icon) to navigate to the and read more about the error and how to fix it.
Checklist (insect icon)
Select this option from the menu on the left side of the page. This page shows a list of all checks that need action, sorted by priority:
Issues to Fix: Errors must be fixed for compliance.
Warnings: Warnings are likely to be issues, but they require manual investigation.
Reviews: Reviews require manual judgement.
Select the compliance level to filter for:
Level A
Level AA
Level AAA
Ignored
Passed.
The results are displayed in a table with the following headers:
Check: This column shows the name and description of the check that is done.
Responsibility: This column shows the designated team or teams that are normally responsible for fixing this type of error. This column is automatically filled in. The areas of responsibility are:
UX Design
Front end development
Content authoring
Visual design.
Success Criteria: This column shows a list of the compliance success criteria category.
Help Center: Click to navigate to the Accessibility Guide for more details about the issue and some suggestions on how to fix it. For more information, visit About the Accessibility Guide.
Action Button: This column contains an Action button for each list item. Click the button on the same row as an issue for more options:
Ignore this check: Issues that are set to Ignore are permanently omitted from future scans and compliance scores.
Domain Compliance: This column shows the percentage of compliance on this domain.
Pages: This column lists the number of pages that have the error. Click to navigate to the error page to view:
The URL for all of the pages where the error occurs.
Suggestions on how to fix the issue.
Guidelines
Select this option from the menu on the left side of the page. This page is a list of the most basic WCAG guidelines that the scan locates and identifies, which do not meet the requirements. This section provides instructions on how to navigate the data and how to use the findings to repair issues.
The results are shown on this page in a table with the following headers:
Name and category of the guideline
Error: This column shows the errors from the most recent scan. Click the bug icon. The List of Accessibility Issues page opens. The issues are shown in a table format. The columns are:
Title and URL: This column shows a list of the page title and URL where the error is. Click the link to navigate to the detailed scan results for the page.
Labels: This column shows the labels for the domain.
For more information and instructions for admin users on how to create labels, visit Create and apply labels.
Priority: This column shows the level of priority that the page has. Priority is High, Medium, or Low.
Views: This column shows the number of views for the page since the last scan.
Each row has the additional options to:
Open page details (the page icon): Click to view the page dashboard. The Accessibility Page Details page opens. Depending upon the level of compliance that is selected, the following information is displayed.
The issues are listed on the left side of the page. Select an issue to view the details about the issue and some suggestions on how to fix it.
Fix the issue from the right side of the page.
Review All Issues
IgnoreCheck: Use this option:
If the issue is incorrectly marked as broken.
To ignore issues on a single-page basis.
To ignore all other issues on a domain level.
Inspect Page with Browser Extension (magnifying glass icon): Click to navigate to the page URL and view the page with the web browser extension.
: If it is installed, use the web browser extension to identify the placement of the errors on the page, repair the errors, and more.
Select this option from the menu on the left side of the page. This page shows a list of all of your website pages that contain ignored checks. This section provides instructions on how to navigate through the data and handle ignored checks.
The column headers are:
Title and URL: Lists the page title and the URL. Click the link to navigate to the detailed scan results for the page.
Click a page link to navigate to the WCAG Accessibility Compliance detail view for the page.
The list headers are:
Checks: Lists the WCAG compliance check, as well as the team that normally is responsible for fixing issues and the criteria identifier.
Individual issues: Shows the number of unique issues found with the check.
Click to select an issue. The pane on the right-hand side of the page updates to show actions that can be made to the issue.
Sort for:
Pending to view pending actions.
Ignored to view ignored issues.
Review all issues: Click to review all issues. A dialog opens. Fill in a free-text reason and then click OK.
Ignore check: Click to ignore the check. A dialog opens. Fill in a free-text reason and then click OK.
Mark check as fixed: Click to mark the check as fixed. A dialog opens. Click OK to mark the check as Fixed.
Note
The difference between Mark as Fixed and is that issues that you mark as are still included in future scans and can be flagged again if the error comes back. Issues that you mark as are permanently removed from future scans and all compliance scores.
Each row has the additional options to:
Open page details (the page icon): Click to view the page dashboard. The Accessibility Page Details window slides open. Depending upon the level of compliance that is selected, the following information is displayed:
The issues are listed on the left side of the page.
Issue list: Click to highlight an issue. On the right side of the page, the details about the issue and some suggestions on how to fix it are shown.
Fix the issue from the right side of the page.
Review All Issues
IgnoreCheck: Use this option:
If the issue is incorrectly marked as broken.
To ignore issues on a single-page basis.
To ignore all other issues on a domain level.
Inspect Page with Browser Extension (magnifying glass icon): Click to navigate to the page URL and view the page with the web browser extension.
Tip: If it is installed, use the web browser extensionto identify the placement of the errors on the page, repair the errors, and more.
This section gives instructions on how to remove a reviewed issue. Do these steps in the Audit Log section.
This procedure is for issues marked as Reviewed in the Accessibility Fast Track module or through the Page Details view. The Undo a Check Review option returns the issue to the errors view on the page and module where it occurs.
Click Audit Log from the menu on the left side of the page.
On the same row as a reviewed issue, click Action.
The Action menu expands with the following options:
Show Details
Undo Check Review.
Select Undo Check Review.
The issue is gone from the audit log and returns to the errors view on the page and module where it occurs.
If you change the accessibility level, the existing Accessibility Score scan information is erased and the new standard starts over from the beginning with the next scan. All of the history is lost. It is advised to activate a new level only when you are ready to make the updates needed, or if it becomes a legal requirement for your location and organization. If you enable the option to Exclude checks that require manual review, you might not see other potential accessibility violations on your website.
It is not recommended to require Level AAA conformance s a general policy for entire sites because it is not possible to satisfy all Level AAA Success Criteria for some content.
Level AA of WCAG 2.1 is the legal requirement to be considered accessible. WCAG 2.2 is newly released and will soon be the standard, taking over from WCAG 2.1.
When you switch to a different guideline, the compliance score can show a sudden change. A dashed line on the graph shows when the update was done and indicates the old value and the new value of the compliance score. This appears on the first scan after the guideline update.
The orange annotation appears on the compliance chart in the Accessibility module and the Accessibility section of the History Center.
The Accessibility guide provides guidelines on WCAG 2.0 and some common 2.1 requirements.
To navigate to the accessibility guide and view all of the available articles, visit Accessibility guide.
For instructions on how to access the Accessibility guide from within the platform interface and be directed to the article that is relevant to a specific error, visit About the Accessibility guide.
On the same row as an error, from the Check List page, the Page View, or the Accessibility Fast Track page, click Help Center (graduation cap icon).
Checklist view
Accessibility Fast Track view
History Center
The History Center stores all accessibility issues and details from previous scans.
The compliance score for the accessibility checks is calculated by using 100 (a perfect score) minus the number of errors found. This is then divided by the total number of accessibility checks.
For example: If the compliance for individual accessibility checks is calculated by the
total number of pages minus pages with issues
for the
check total number of pages multiplied by 100
It will make no difference if there are 10 or 10.000 issues, it calculates the number of pages that fail the check as opposed to the total number of pages.
Accessibility reports
This section provides information about the different accessibility reports that are available.
The available reports for the Accessibility feature are:
Accessibility Summary Report
Accessibility Checks Report
Pages with Accessibility Issues Report
Classic Accessibility Report
Accessibility Guidelines Report
PDF Review Report
Click Schedule This Report (calendar icon) on the same row as the report to receive the report as an email attachment. Multiple selection is allowed.
Click Open Report (eye icon) to get the newest report.
Click Report Administration (gear icon) to add other users to receive the report.
Fix the issue from the right side of the page with these choices:
Review All Issues: Use this option to mark all issues Reviewed.
Ignore Check: Use this option:
If the issue is incorrectly marked as broken
To ignore issues on a single-page basis
To ignore all other issues on a domain level.
Mark as fixed: Use this option when the issue is fixed on the website. Items that are marked as fixed are included in future scans.
Note
The difference between Mark as Fixed and Ignore Check is that issues that you mark as Fixed are still included in future scans and can be flagged again if the error comes back. Issues that you mark as Ignore are permanently removed from future scans and all compliance scores.
Open Issue Page: (an i for information icon) on the same row as an issue.
Unignore: Select the filter for Ignored Checks. Click on an issue in the list. The right side of the page updates. The options to handle the ignored check are:
Remove review for all issues: Click to review all issues for the check. A dialog opens. Fill in a free-text reason and then click OK.
Unignore check: Click to unignore an ignored check. A dialog opens. Fill in a free-text reason and then click OK.
Mark check as fixed: Click to mark the check as fixed. A dialog opens. Click OK to mark the check as Fixed.
Labels: This column shows the labels for the domain.
Title: Lists the page title and the URL. Click the link to navigate to the detailed scan results for the page.
Action: Press and select Review to mark the document as Reviewed.
Did not find what you were looking for?
If this content did not answer your questions, try searching or contacting our support team for further assistance.
Accessibility Help Center
Accessibility Help Center
Fix the issue from the right side of the page with these choices:
Review All Issues: Use this option to mark all issues Reviewed.
Ignore Check: Use this option:
If the issue is incorrectly marked as broken
To ignore issues on a single-page basis
To ignore all other issues on a domain level.
Mark as fixed: Use this option when the issue is fixed on the website. Items that are marked as fixed are included in future scans.
Note
The difference between Mark as Fixed and Ignore Check is that issues that you mark as Fixed are still included in future scans and can be flagged again if the error comes back. Issues that you mark as Ignore are permanently removed from future scans and all compliance scores.
Open Issue Page: (an i for information icon) on the same row as an issue.
Unignore: Select the filter for Ignored Checks. Click on an issue in the list. The right side of the page updates. The options to handle the ignored check are:
Remove review for all issues: Click to review all issues for the check. A dialog opens. Fill in a free-text reason and then click OK.
Unignore check: Click to unignore an ignored check. A dialog opens. Fill in a free-text reason and then click OK.
Mark check as fixed: Click to mark the check as fixed. A dialog opens. Click OK to mark the check as Fixed.
Labels: This column shows the labels for the domain.
Web Governance