Skip to main content Skip to navigation

Check for broken links

Broken links can occur when someone deletes, renames or moves a target page, image or file. Its good practice to:

  • Regularly check your site to identify and correct broken links as a routine task.
  • Review your site for broken links after a significant restructure.
  1. Browse to the uppermost page in the section you want to review.

  2. Go to Edit > More, then select the Current page tab.

  3. In the Manage content section, select Check for broken links and images:

    The 'Current page' tab in SiteBuilder, with the option to 'Check for broken links and images' highlighted

  4. In the Link checks page, select the Also check links and images on pages beneath the current page checkbox to have SiteBuilder check for broken links on everything below the current level of the site.

    The 'Link checks' screen

  5. Select Run links check.

    Note: When the link check involves more than 25 total pages, images and files, you receive an email notification when the check completes. The email contains a link to view the report in SiteBuilder and a .csv file of the results. For smaller sections, the report appears immediately in SiteBuilder.

  6. When your report is ready, review the Check summary at the top of the page:

    A link check summary

  7. The summary shows the number of web addresses (URLs) checked, grouped by result:

    • Successful: Links that work correctly.

    • Permissions locked: The target page or file has more restrictive permissions than the source page. This means a visitor following the link may not necessarily have permissions to view the target page.

      Tip: Consider using conditional content to make links to restricted pages visible only to visitors who have permission to view the target content. This avoids a signed-in user following a link and seeing an Access refused page

    • Not found: Links to pages, images or files that do not exist at the target URL, likely because they have been moved, renamed or deleted. You should update your link to point to te correct target or remove the link from your page.

    • Insecure: Links to pages, images or files that do not use an encrypted connection, i.e., the URL starts with http:// instead of https:// (HTTP Secure). We recommend that you manually update these to point to the secure version, where available.

    • Unknown: SiteBuilder could not determine the status of these links. There are several possible reasons for this, such as URLs containing a backslash (\), or a page hosted on a server with an invalid SSL certificate. We recommend you inspect these links manually to ensure they're correct.

  8. Select the Details section to expand it and view the results for each page:

    Part of the 'Details' section of a site Link checks report

    Tip: To make it easier to identify problematic links, particularly for large reports, unselect the Show details for pages with no warnings checkbox.

  9. Select the Link opens in a new window icon at the end of each page's web address to open that page in a new window.

  10. Visit any pages containing problematic links, correct or remove them, then Publish the page.

Related articles