Introduction¶

This document provides instructions on how to find and repair broken links with the Quality Assurance feature.

Instructions¶

To navigate to the Quality Assurance module:

1. Click Quality Assurance (the checkbox icon), on the Dashboard toolbar.

   

2. The Quality Assurance page opens.

   

3. Click Links from the menu on the left.

   
4. The menu expands with the following options:
   • Content with Broken Links
   • Broken Links
   • Broken Images.

Content with Broken Links¶

Click this option in the Links sub-menu on the left side of the page to view the URLs of any pages that contain broken links. This is the default page that opens when Links is selected.

• Navigate between All, Pages, PDF Documents, and Text Documents.
• Click Export to export the list.

  • A dialog box opens. Select your export file:

    • Broken Links with Page Count
    • Broken Links Per Page.

    A message informs that, "Your export is currently being generated, You will receive an email when the export is ready." To view the progress, click the avatar icon on the main toolbar and select My Exports, or click Go to My Exports.

• Click Filter (the funnel icon) to filter for:
  • Labels
  • Type
  • Response code
  • Internal or external.
• Search: Click in the dialog box and type a search string.
• The table with the results has the headers:
  • Title and URL: This is the title and URL of the content that has been targeted with errors. Click the URL. The Broken Links pane slides open.
  • Notifications: Click to expand a quick-info box on the notifications for the URL.

  • Priority: Low, Medium, High as determined by the number of page views.

    For more information, visit:

    Issue priority

  • Views: Approximate number of page views since the last scan. This information is only available when Statistics is enabled.

  • Open Issue Page: On the same row as an issue on the right, click Open Issue Page (an i for information icon) on the same row as an issue.

    

    For more information about Issue View, visit:

    Issue view.

  • Open page details (webpage icon): On the same row as a page, click Open Page Details.

    

    The details page opens.

    

Broken Links¶

Click this option in the Links submenu on the left side of the page to see the overview and status of broken links.

• Filter for All broken links, ignored, and Marked as fixed.
• Click Export to export the list.

  • A dialog box opens. Select your export file:

    • Broken Links with Page Count
    • Broken Links Per Page.

    A message informs that, "Your export is currently being generated, You will receive an email when the export is ready." To view the progress, click the avatar icon on the main toolbar and select My Exports, or click Go to My Exports.

• Click Filter (the funnel icon) to filter for:
  • Labels
  • Type
  • Response code
  • Internal or external.
• Search: Click in the dialog box and type a search string.

• The table with the results has the headers:

  • Broken Link: This is the link that is broken. Click the URL. The Broken Links page opens.
  • PageCorrect: Click to navigate to PageCorrect to view and correct the error. 
    For more instructions, visit: 
    PageCorrect.
  • Response code: This column shows the error code that is received for the link.
  • Type: This column lists the type of error that is detected.
  • Pages: This column gives information on where the broken link is located.
    • Documents: The broken link is found in this many documents.
    • Pages: The broken link is found on this many pages of the website.
  • Action: Click the button to expand the list of actions to take for the link. Select from the following:
    • Mark as fixed: Marks the link as fixed. It will be included in subsequent scans and if the error returns, it will appear again in the broken links list. Select this option when the error is actually fixed by the web team on the HTML code of the webpage, or if it is a temporary (for example, in an unpublished state) known issue.

    • Mark as ignored: Ignore the link. Use this option if you know the link is not broken. Ignored links are not included in subsequent scans and will not show up as broken.

      Note

      The following is the crucial difference between the issues that you mark as fixed and issues that you mark as ignore:

      • Issues that are marked as fixed are flagged upon future scans

      • Issues that are set to ignore are permanently omitted from future scans and future compliance score calculations, as long as the link gives the same broken error.

      Ignored links are displayed on the scan again if the status of the link changes. For example, a link previously marked as broken with a 404 status and ignored is reset if the link later receives a new "Ok" status, such as 200. If the same link starts to return a 404 error in the future, it is displayed on the broken links report again.

      For information on how to set up the scan to exclude a link so that it is never considered, visit:

      • Path constraints and link exclusions.

  For more information, visit:

  Ignored links.

Broken images¶

Click this option in the Links sub-menu on the left-hand side of the page to view the list of images that have broken links.

Tip: An example of a broken image could be an icon button with a broken path.

• Click Open Issue Page (an exclamation point icon) to see all of the broken image links on a single page.
• Click Filter ( the funnel icon) to filter for:
  • Labels
  • Type
  • Response code
  • Internal or external
  • Search: Click in the dialog box and type a search string.
  • The table with the results has the headers:
    • Broken Link: This is the link that is broken. Click the URL. The Broken Links page opens.
    • PageCorrect: Click to navigate to PageCorrect to view and correct the error. 
      For more information, visit: 
      PageCorrect.
    • Response code: This column shows the error code that is received for the link.
    • Type: This column lists the type of error that is detected.
    • Pages: This column gives information on where the broken link is located.
      • Documents: The broken link is found in this many documents.
      • Pages: The broken link is found on this many pages of the website.
    • Action: Click the button to expand the list of actions to take for the link. Select from the following:
      • Mark as fixed: Marks the link as fixed. It will be included in subsequent scans and if the error returns, it will appear again in the broken links list. Select this option when the error is actually fixed by the web team on the HTML code of the webpage, or if it is a temporary (for example, in an unpublished state) known issue.

      • Mark as ignored: Ignore the link. Use this option if you know the link is, in fact, OK. Ignored links are not included in subsequent scans and will not show up as broken.

        Notes

        The following is the crucial difference between the issues that you mark as fixed and issues that you mark as ignore:

        • Issues that are marked as fixed are flagged upon future scans

        • Issues that are set to ignore are permanently omitted from future scans and future compliance score calculations, as long as the link gives the same broken error.

        Ignored links are displayed on the scan again if the status of the link changes. For example, a link previously marked as broken with a 404 status and ignored is reset if the link later receives a new "Ok" status, such as 200. If the same link starts to return a 404 error in the future, it is displayed on the broken links report again.

        For information on how to set up the scan to exclude a link so that it is never considered, visit:

        • Path constraints and link exclusions.

For more information, visit:

Fix broken links.

Quality Assurance reports¶

The available reports for the Quality Assurance module are:

• Quality Assurance Report
• Pages with Quality Assurance Errors Report
• Broken Links report
• Misspellings report
• Pages with Misspellings report
• Potential Misspellings report
• Readability Score report
• Broken Links Per Page report
• Misspellings Per Page 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. See the Schedule a Report section in this document for instructions.
2. Click Open Report (eye icon) to get the newest report. See the View a Report section in this document for instructions.
3. Click Report Administration (gear icon) to add other users to receive the report. See the Add Users to Receive a Report section in this document for instructions.