Introduction¶

This document provides instructions on how to navigate the Accessibility dashboard and how to find and repair accessibility issues with this Acquia Optimize feature.

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. For more information, see the Accessibility Compliance Score section in this article.

Industry average¶

This figure shows the industry-wide average of accessibility compliance. The results appear in the Accessibility Diagnostics section.

For more information, see the user guide article:
​Industry average.

Accessibility menu¶

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 page provides an 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, see the user guide article:

  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. This information is given below in a separate section. See the History section of this document for more information.

  For more information, see the user guide article:

  History center.

• 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, see the user guide article:
  ​PDF accessibility scans.

FastTrack¶

Select this option from the menu on the left side of the page. Fix, review, and ignore HTML snippets in bulk.

The Accessibility FastTrack page opens.

For more information, see the user guide article:

Accessibility FastTrack.

Pages with Failing Checks¶

Select this option from the menu on the left side of the page. The list shows the URLs for pages that have accessibility issues.

The Pages with Failing Checks page opens.

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.

  For more information, see the user guide article:

  Create and apply labels.

• 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.

  For more information, see the user guide article:

  Issue priority.

• 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 Accessibility Help Center button (graduation cap icon) to navigate to the Accessibility Help Center and read more about the error and how to fix it.
  • 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.

      

      For more information about Issue View see the user guide article:

      Issue view.

• 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 our web browser extension to find the errors on the page, repair the errors, and more.

  For more information, see the user guide article:

  Web browser extension.

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 are done for the selected category.

Select the compliance level to filter for on the Accessibility Checklist page:

• Level A
• Level AA
• Level AAA
• Ignored
• Passed.

Filter the list for:

• Responsibility
• Labels
• Accessibility Error Type.

The results are shown 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.
• Related to Success Criteria: This column shows a list of the compliance success criteria category.

• Help Center: Click to navigate to the Help Center to see the details about the issue and some suggestions on how to fix it.
  For more information, see the user guide article:

  About the Accessibility guide.

• Action Button: This column has a button. Click the button 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 errors.
  • Information about the designated team or competence that is needed to fix this type of error.

For a list of all of the checks, see the user guide article:

Accessibility checks.

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. The scan finds issues that do not meet the requirements.

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, see the user guide article:

    Create and apply labels.

  • Priority: This column shows the level of priority that the page has. Priority is High, Medium, or Low.

    For more information, see the user guide article:

    Issue priority.

  • 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
  • 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.
  • 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 extension to identify the placement of the errors on the page, repair the errors, and more.

For more information, see the user guide article:

Web browser extension.

Pages with Ignored Checks¶

Select this option from the menu on the left side of the page. This page shows a list of the pages that contain 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 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.

  • 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.

  For more information and instructions for admin users, see the user guide article:

  Create and apply labels.

• Ignored Checks: This column shows the total number of ignored checks.
• Page Compliance: Percentage of compliance on the page.

• Priority: This column shows the level of priority that the page has. High, Medium, or Low.

  For more information, see the user guide article:

  Issue priority.

• Views: The number of views that the page has.

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
  • 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.
• 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 extension to identify the placement of the errors on the page, repair the errors, and more.

  For more information, see the user guide article:

  Web browser extension.

PDFs¶

Select this option from the menu on the left side of the page.

The menu expands with the following choices:

• Internal PDFs: Click to select this option.

  

  The Internal PDF Compliance page opens. This page shows the Internal PDF file accessibility compliance issues in a graph and a table.

  Sort the table for issues that are:

  • Pending
  • Reviewed/OK
  • Queued
  • Failed.

  The table menu items are:

  • Title: Lists the page title and the URL. Click the link to navigate to the detailed scan results for the page.
  • File Size: This shows the size of the PDF.
  • Pages: The number of pages that contain the link to this PDF.
  • Words: The number of words in the PDF.
  • Created: The date that the PDF was created.
  • Remediation Quote: Click to request a quote for PDF remediation from the external Acquia Optimize affiliate.
  • Action: Press and select one of the following options:
    • Mark as reviewed: Mark this document as reviewed.

    • Start PDF Accessibility Scan:

      For more information, see the user guide article:

      PDF accessibility scans.

• External PDFs: Click to select this option.

  

  The External PDF Compliance page opens. This page shows the external PDF file accessibility compliance issues in a graph and a table.

  Sort the table for issues that are:

  • Pending
  • Reviewed/OK.

  The table menu items are:

  • 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.

For more information, see the user guide articles:

• Configure scans for password-protected and internal-only pages
• PDF accessibility scans.

Tools¶

Select this option from the menu on the left side of the page.

Click to select Color Contrast Tool.

Enter the color codes of the text and background that is used on your site to see if it meets the criteria for color contrast accessibility standards.

See the contrast ratio for foreground and background color, font size, and graphical elements. The page shows how well the PDF page meets GDPR standards.

1. Enter the background and foreground color in RGB, hexadecimal format - or pick a color using the color picker.
2. Adjust the lightness level.

The tool gives a green PASS indicator if the color contrast is sufficient, or a FAIL indicator to let you know that the colors do not contrast enough to meet the criteria of the check.

Tip! The Color contrast checker web version is another quick way to test the color combinations on websites and pages, without logging in to the platform.

For more information, see the user guide article:

Fix color contrast.

Unignore an issue¶

Click a page link and filter for the Ignored Checks detail view for the page.

Click to select an issue. The pane on the right-hand side of the page shows actions that you can do to the issue.

• Click Pending to view pending actions.
• Click Ignored to view ignored issues.

• Click Unignore to remove the item from the list.

  

Undo a review on an issue¶

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 FastTrack® module or via 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.

1. Click Audit Log from the menu on the left side of the page.

   

2. On the same row as a reviewed issue, click Action.

   
3. The Action menu expands with the following options:
   • Show Details
   • Undo Check Review.
4. 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.

For more information, see the user guide article:

Accessibility FastTrack.

Accessibility guide¶

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.

To instructions on how to access the Accessibility guide from within the platform interface to be directed to the article that is relevant to a specific error, see the user guide article:
About the Accessibility guide.

1. On the same row as an error, from the Check List page, the Page View, or the Accessibility FastTrack page, click Help Center (graduation cap icon).

   Checklist view

   

   Accessibility FastTrack view

   

For more information, see the user guide article:

About the Accessibility guide.

History Center¶

The History Center stores all accessibility issues and details from previous scans.

• Click History Center (bar graph icon), located on the top menu bar of any page within the platform.

  

  The History Center landing page opens.

  

  The page contains the following layout:

• Domain: In the first field, click to expand the list of domains.

  
• Click to select a domain from the list or switch to another domain.

• Module: In the second field, click to expand the list of available modules.

  
• Click to select Accessibility from the drop-down list. The Accessibility page of the History Center opens.
  • The top section gives information on the profile that is being used for the results shown.

    • Viewing as Profile: This shows the profile that is being used.

      For more information, see the user guide article:

      Performance.

    • Device: The type of device used.
    • Measure from: Distance from the server location.
    • Network speed: The speed of the network.
    • Check frequency: The frequency of the check.
    • Important

      The dashboard always shows data with the default profile selected. To change this, select a new profile (click the drop-down arrow to see the available profiles). Please be aware that when you change the profile, the numbers on all 3 sections inside the Performance module update accordingly.

  • Graph with performance speed and date as well as a donut chart showing the average performance score.
  • Scan history results: This table shows valuable scan data from previous scans.
  • Scan history results: This table shows valuable scan data from previous scans.
    • Crawled at: Date and time of scan.
    • Pages crawled: Number of pages scanned.
    • Domain compliance: Percentage of compliance achieved.
    • Comparison to average: The score of the website as compared with the average score within the industry.
    • Failing checks: The number of checks that do not pass the accessibility checks, broken down into category icons.
    • Issues: Total number of accessibility issues that need to be handled.
    • Changes since previous crawl: Percentage of changes made since the last scan.
      For more information, see the user guide article: 
      ​History center.

Accessibility compliance score¶

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 gives 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.

1. 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.
2. Click Open Report (eye icon) to get the newest report.
3. Click Report Administration (gear icon) to add other users to receive the report.

For more information, see the user guide article:

Accessibility reports.

Additional resources¶

For information on how to set up and configure the Accessibility feature, see the admin user guide article:
Accessibility setup.