Broken Links Report

The Broken Links Report displays the results of the scheduled Broken Link Checker. Only pages and files that are marked as publishable are scanned for broken links. Learn how to access the report and fix broken links below.

Expand All
  • Enabling the Report

    To enable the Broken Links Report for your site:

    1. Hover over the widget and click the pencil icon in the upper-right corner.
    2. Choose your site from the Site menu. 
    3. Click Save Settings.
    A report will be available for the site in the Reports area after the next scheduled report date/time. Link Checker reports are run daily at 3 am.
  • Viewing the Report

    Once the Broken Links Report has been enabled for your system and run for at least one site, you can view the report by selecting the reported broken links total within the widget.

    The top portion of the Broken Links report contains a summary of the number of assets containing broken links, the total number of broken links, the number of broken links ignored, and the number of broken links that have not been marked as fixed or ignored since the last time the scheduled Link Checker was run.

    Below the overview is a results list of all broken links encountered during link checking. These links can be grouped by link, which displays all assets containing a particular broken link, or by asset, which displays all broken links found for each asset checked.

    The results list contains the following information:

    • Source - The asset in which the broken link was rendered.
    • Occurrences -
      • When grouping by link, this column will indicate the number of assets that were found to have been using a particular link.
      • When grouping by asset, this column will indicate the number of broken links in the current asset.
      • Clicking Show in this column will display either all assets containing a particular broken link or all links contained in a particular asset depending on whether the report is being grouped by link or by asset, respectively. Clicking Hide will collapse the rows.
    • Type -
      • Internal links are links to resources within the system such as Files or Pages.
      • External links are links to resources outside the system.
    • Link Description -
      • For hyperlinks, the link description is the text contained inside the element or "Link with no text".
      • For other types of links, this column will contain a description of the type of tag containing the link to help users locate the link on the page (e.g. "Broken image source").
    • Broken Link - This is the value of the attribute that is considered broken. For an "<a>" tag, this would be the value of the "<href>" attribute.
      • Hover over or click on the question mark icon next to the link for more information on why the link is considered broken.
      • Refer to the Elements Checked for Broken Links for a full listing of elements and attributes that are checked for broken links.
    • Status - This column indicates whether or not the broken link has been fixed yet or not.
      • Users can click the dropdown and select Fixed to indicate that the link has been fixed in some way, or Ignored to indicate that the link should be excluded from the Link Checker.
      • Marking a link as Fixed or Ignored will reduce the number of links that are considered broken in the Broken Links Remaining summary of the report.
      • Links marked as Fixed will be displayed as Fixed for all other users in the system. Note that a status of Fixed will revert back to its original value of Broken the next time the Link Checker runs if the link has not actually been fixed inside the corresponding asset.
      • The first row in each set of grouped rows in the report will have two additional values in the status dropdown: Mark all fixed and Mark all broken. These values will mark all grouped rows as either Fixed or Broken, respectively.
  • Filtering the Report

    The following filters are available to refine the results of the report:

    • Site - A Site must be selected to display report data.
    • Group By -
      • Grouping by Asset displays all broken links found for each asset checked.
      • Grouping by Link displays all assets containing a particular broken link.
    • Type -
      • Internal links are links to resources within the system such as Files or Pages.
      • External links are links to resources outside the system.
    • Hide Fixed - When this option is enabled, links marked as Fixed are hidden from the report.
    • Show Ignored - When this option is enabled, links marked Ignored are displayed in the report.
  • Fixing Broken Links

    To fix a broken link:

    1. Locate the link you’d like to fix in the Broken Link column.
    2. Edit the asset listed in the Source column.
    3. You can  fix the link manually by searching for it in the content of the asset.
    It’s important to note that although a "source" asset is listed with each link, the broken link itself may exist in a supporting asset such as a Template, Format, or Block. These and other non-publishable supporting assets don’t get checked for broken links directly. When following the steps above, if the broken link can’t be found, then it’s likely that the broken link exists in a supporting asset.