There are several ways to locate and repair broken links. This article provides instructions on each of the methods.
List and repair broken links with PageCorrect.
Click PageCorrect (shield with a checkmark icon) on the window toolbar. The PageCorrect dashboard opens.
Click List from the menu on the left side of the page.
The PageCorrect Content page opens. The results are in a table format.
Filter: On the toolbar above the results list, select to filter for Links.
Select Update from the expanded menu. A dialog opens:
The dialog has a field with the existing URL and the instructions: "Please insert correct URL:"
Enter the correct URL in the field provided. The URL must start with a protocol such as http://.
All links that lead to the same destination are listed. The first five are displayed, but the full number of URLs discovered is shown. Click the number to expand them.
Click Save. This fixes the broken link in all instances throughout the website.
If the Acquia Optimize subscription ends, the error will still be present in the website HTML. Acquia Optimize recommends that a web developer fixes the issue within the HTML code. Make a note of the location(s) of the broken link and send it to the web developer for a permanent fix.
Remove to remove the issue from the list.
Select this choice if you know the link is correct and the error occurred due to, for example, a server outage at the time of the last scan.
If the error persists, it will be flagged again.
For more information, visit PageCorrect.
List broken links, Ignore a link, or mark a link as Fixed with the Prioritized Content module.
Click Prioritized Content (bell icon), on the menu bar.
The Prioritized Content page opens.
Click Notifications on the same row as a domain. The menu expands with a breakdown of the notifications per category:
Click to select Broken Links. The Broken Links page opens.
Mark as Ignored: Use this option if links are incorrectly marked as broken.
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 Prioritized content.
Find broken links and their location, Ignore a link, or mark a link as Fixed with the web browser extension.
Click to select Content Issues (insect icon) on the web browser extension toolbar.
Select Quality Assurance in the expanded menu.
Click See Issues in the Broken Links / Broken Images section.
The Broken Links pane opens. Here is a list of broken links and broken image links.
Mark as Fixed (checkmark icon): Click to mark the issue as fixed. Do this when the issue is fixed on the CMS/HTML code of the website. Items that are marked as fixed are included in future scans.
Mark as Ignored (eye with a line through it icon): Do this when the link is not broken, but flagged by the scan for an unknown reason.
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.
HTML (</> icon): Click to view the location of the broken link within the page HTML code.
The HTML code view opens and the broken link is highlighted.
Tip: Send this to the web development team, so that they can quickly find and repair the error within the HTML code.
Highlight (magnifying glass icon): Click to view the location of the broken link on the page.
The page view scrolls to the location of the link and the broken link is highlighted.
For more information, visit Web Browser Extension.
On the web browser extension toolbar, click to select Toolkit (tools icon). The Acquia Optimize Toolkit opens.
Click to turn on the Links button to see a list of all links on the website.
Hover the cursor over a link on the page for more information about it.
See the following information about the link:
For more information, visit Web Browser extension.
List broken links, Ignore a link, or mark a link as Fixed with the Quality Assurance module.
Click Select Domain to expand the Domains list.
Select the domain to open.
Alternatively, from the Domain Overview page, click Open on the same row as the domain name.
The Dashboard for the domain opens.
Click Quality Assurance (the checkbox icon), on the window toolbar.
The Quality Assurance page opens.
Click Links from the menu on the left.
Click this option in the Links sub-menu on the left-hand 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.
Open page details (the page icon): On the same row as a page, click Open Page Details.
The details pane slides open. View the issues on the page, rated per severity, as determined by the last scan.
Click this option in the Links sub-menu on the left-hand side of the page to see the overview of broken links, including broken links that have been marked as ignored or fixed.
PageCorrect: Click to navigate to PageCorrect to view and correct the error.
For more information, visit PageCorrect.
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.
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.
Click this option in the Links sub-menu on the left 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 on the blue circle to see all of the broken links on a single page.
Although the Quality Assurance Module is a highly effective way to find broken links on images, false positives can occur. For best results, it is important to manually review the findings.
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.
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 Quality Assurance: Links.
Click this option in the Links sub-menu on the left-hand side of the page to view the list of links that are located on the sitemap.
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.
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 Handle links with QA.
It is sometimes necessary to set up a policy to tell the scan how to handle special or troublesome links. Acquia Optimize has several pre-made links policies that you can use.
For more information, visit Policy links.
If this content did not answer your questions, try searching or contacting our support team for further assistance.
Tue Jul 29 2025 22:05:27 GMT+0000 (Coordinated Universal Time)