--- title: "Fix broken links" date: "2022-03-25T07:46:27+00:00" summary: "Discover and repair broken links. Learn to use PageCorrect, Prioritized Content, and the web browser extension for efficient link management." image: type: "page" url: "/web-governance/fix-broken-links" id: "7e1c608f-eaee-493b-8134-144b2f60ef04" --- Table of contents will be added Introduction ------------ There are several ways to locate and repair broken links. This article provides instructions on each of the methods. PageCorrect ----------- List and repair broken links with **PageCorrect**. 1. Navigate to the domain dashboard. 2. Click **PageCorrect** (shield with a checkmark icon) on the window toolbar. The _PageCorrect_ dashboard opens. ![The location of the PageCorrect button on the dashboard toolbar.](https://acquia.widen.net/content/70c26203-172e-48ba-9e3a-a1f703dd23ae/web/Mon_Opt_Dashboard-PageCorrect.png) 3. Click **List** from the menu on the left side of the page. ![The location of the List option on the left menu bar of the Page Correct Content page.](https://acquia.widen.net/content/91da917e-b146-4c90-8fc4-425423e5b5fe/web/Mon_Opt_PageCorrect-LeftMenu-ListButton.png) 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**. ![The location of the Links filter on the PageCorrect dashboard.](https://acquia.widen.net/content/5577ade6-fa22-40bf-b330-e85bdb05fb5c/web/Mon_Opt_PageCorrect-PageCorrectContent-Links.png) * The columns are: * **Issue**: The icon for the type of issue, either a broken chain link icon or a broken image icon, along with the title for the issue (Broken Link or Broken Image) and the URL for the issue. * **Changed to**: The last change that was done to the issue. * **Updated at**: The date that the issue was updated last. * **Created at**: The date that the issue was created. * **Action button**: Click to expand the list of options: **Update** or **Remove**. * Click **Action** on the same row as a broken link.  * Select **Update** from the expanded menu. A dialog opens: ![The Fix Broken Link dialog with a field to add the correct link.The instructions are in the document text.](https://acquia.widen.net/content/4df18672-2556-4a48-9447-24e3c066edf5/web/Mon_Opt_PageCorrect-UsePageCorrectToFixBrokenLinkDialog) 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://._ Note 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. Note If the Acquia subscription ends, the error will still be present in the website HTML. It is the recommendation to have a web developer fix 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. Note If the error persists, it is flagged again on subsequent scans. For more information, visit [PageCorrect](/node/58966/). Prioritized Content ------------------- List broken links, _Ignore_ a link, or mark a link as _Fixed_ with the **Prioritized Content** module. 1. Navigate to the domain dashboard. 2. Click **Prioritized Content** (bell icon), on the menu bar. ![The location of the Prioritized Content button on the domain toolbar.](https://acquia.widen.net/content/78f3e3ba-f1f8-439d-a895-5363d887d7ac/web/Mon_Opt_Dashboard-PrioritizedContent.png) The _Prioritized Content_ page opens. ![The landing page for Prioritized Content. The description of the page is in the document text.](https://acquia.widen.net/content/ffd1c53c-ded2-4903-a057-d5b82532bbb1/web/Mon_Opt_PrioritizedContentDashboard.png) 3. Click **Notifications** on the same row as a domain. The menu expands with a breakdown of the notifications per category: * Policies * Broken links * Broken images * Misspellings * Accessibility * SEO ![The Notifications menu that expands to show the number and types of notifications for each domain.](https://acquia.widen.net/content/eafccac9-82b9-4e83-8c23-993f5a7a4b9e/web/Mon_Opt_PrioritizedContent-NotificationsMenu.png) 4. Click to select **Broken** **Links**. The _Broken Links_ page opens. ![The page details view. The default selection shows Broken Links.](https://acquia.widen.net/content/c63d6103-ab77-4ded-b822-294a5bea8f96/web/Mon_PrioritizedContent-PageDetails-BrokenLinks.png) 1. The number on the right tells you how many broken links the URL has. 2. The columns on the list have these headers: * **Broken Link**: the URL for the link. * **PageCorrect:** Click to navigate to the PageCorrect module, where it is also possible to fix the highlighted link. Instructions are in the next section of this document. * **Response code**: The error code that the URL returns. * **Type**: The type of error (in this case, **link**). 5. Click **Action**. The menu expands with the following options: * **Set to Fixed:** Use this option 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**: Use this option if links are incorrectly marked 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](/node/58571/). * **Inspect** (Magnifying glass icon): Click to navigate to the Web Browser Extension view of the page, where it is possible to fix the highlighted link. Skip to Web Browser Extension instructions. For more information, visit [Prioritized content](/node/58666/). Web browser extension --------------------- Find broken links and their location, _Ignore_ a link, or mark a link as _Fixed_ with the web browser extension. 1. Open the website and start the **Web Browser Extension**. 2. Click to select **Content Issues** (insect icon) on the web browser extension toolbar. ![The location of the Content Issues button on the extension toolbar.](https://acquia.widen.net/content/5cf9b0ae-f577-414a-b4d1-810adf098443/web/Mon_Opt_WebBrowserExtension-Toolbar-ContentIssuesButton.png) 3. Select **Quality Assurance** in the expanded menu. ![The location of the Quality Assurance button on the web browser extension menu bar, and the expanded menu. The description is in the document text.](https://acquia.widen.net/content/3bc3b80a-240c-4b68-a7fe-cd67bdcbaff9/web/Mon_WebBrowserExtension-QAButton.png) 4. Click the arrow to expand the menu further. The issues list opens. 5. Click **See Issues** in the _Broken Links / Broken Images_ section. ![The location of the See Issues button for an issue on the web browser extension.](https://acquia.widen.net/content/368adfc3-0cbc-41a8-84d9-ad3cf1f810da/web/Mon_WebBrowserExtension-SeeIssuesButton.png) The _Broken Links_ pane opens. Here is a list of broken links and broken image links. ![The All Broken Links section in the web browser extension. The fields are described in the document text.](https://acquia.widen.net/content/8c8e8a03-59bb-444a-825e-1a210d44e409/web/Mon_WebBrowserExtension-AllBrokenLinks.png) 6. **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. ![The location of the Mark As Fixed button on the All Broken Links section in the web browser extension.](https://acquia.widen.net/content/3348421a-50d3-4e82-9d4e-946291342631/web/Mon_WebBrowserExtension-AllBrokenLinks-MarkAsFixed.png) 7. **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 location of the Mark As Ignored button on the All Broken Links section in the web browser extension.](https://acquia.widen.net/content/ff2bd814-adb8-4fcb-b896-17e11a5af233/web/Mon_WebBrowserExtension-AllBrokenLinks-MarkAsIgnored.png) 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](/node/58571/). 8. **HTML** ( icon): Click to view the location of the broken link within the page HTML code. ![The location of the HTML button to see the location of broken links in the page code.](https://acquia.widen.net/content/0e5890af-bdd8-4fe9-9a58-9dc91933cb04/web/Mon_Extension-Links-BrokenLinks-HTMLButton.png) The HTML code view opens and the broken link is highlighted. ![A broken link in the HTML code as it looks when it is highlighted with the web browser extension.](https://acquia.widen.net/content/d3512e0d-5c40-4fb1-9019-81c8d2e5610f/web/Mon_Extension-BrokenLinkInHTML.png) _Tip_: Send this to the web development team, so that they can quickly find and repair the error within the HTML code. 9. **Highlight** (magnifying glass icon): Click to view the location of the broken link on the page. ![The location of the View on Page button on the All Broken Links section in the web browser extension.](https://acquia.widen.net/content/515f8ced-cd94-42d6-9e7b-7f379dd37ab2/web/Mon_WebBrowserExtension-AllBrokenLinks-ViewLinksOnPageButton.png) The page view scrolls to the location of the link and the broken link is highlighted. ![A broken link on a page as it looks when it is highlighted with the web browser extension.](https://acquia.widen.net/content/bd797905-2a7c-4a5e-b4f5-378fb3160d43/web/Mon_Extension-BrokenLinkOnPage.png) For more information, visit [Web Browser Extension](/node/58711/). **Examine links for accessibility issues** ------------------------------------------ 1. On the web browser extension toolbar, click to select **Toolk**it (tools icon). ![The location of the Toolkit button on the web extension toolbar.](https://acquia.widen.net/content/37ac1868-ff38-458d-91d1-31e453629f5e/web/Mon_Opt_WebBrowserExtension-ToolkitButton.png) 2. Click to turn on the **Links** button to see a list of all links on the website. ![The location of the Show Links button in the Links section of the Web Browser Extension.](https://acquia.widen.net/content/b3aefd80-f3d5-4ef2-a79c-72af04182e5c/web/Mon_WebBrowserExtension-Links-ShowLinksButton.png) 3. Click on a link in the list to see the location on the website. 4. Hover the cursor over a link on the page for more information about it. ![The information that appears when you hover the mouse over a link, as described in the document text](https://acquia.widen.net/content/32eb233a-4485-45f1-b484-cfa9f7701d29/web/Mon_WebBrowserExtension-Links-LinkHover.png) See the following information about the link: * Link Text * Link Title * Link URL * Aria-label * Link Length * Link Target 5. Click on a link on the page to see the link behavior as a user experiences it. For more information, visit [Web Browser Extension](/node/58711/). Quality Assurance Links ----------------------- List broken links, _Ignore_ a link, or mark a link as _Fixed_ with the **Quality Assurance** module. For instructions, visit [Handle links with QA](/node/60731/) Policies for links ------------------ It is sometimes necessary to set up a policy to tell the scan how to handle special or troublesome links. There are several pre-made _links policies_ that you can use. For more information, visit [Policies for links](/node/58761/).