Fixing broken links

To simplify the update process, login to WordPress in another tab in your browser window.

Navigate to a detail page

View and fix broken links on your webpage by navigating to the detail page:

Option 1: Major issue categories appear at the top the dashboard display. Identify the type of issue (broken links) you want to work on, and click on the “X pages” link to view a list of affected pages. Select the page URL to open the details for that page.

Option 2: Use the Quick Wins panel to see a list of pages with issues. Click on a URL and it will take you to the details page. You can also filter the Quick Wins listing by issue type (such as Broken Links).

Review the issue

On your detail page, follow these steps to review and resolve the broken link issue:

Step 1

Click on the Broken Links icon and a panel will slide to the right to display the issues that were found.

Step 2

After clicking on the issue link from step 1, the down arrow caret will display details about the issue. In this scenario, DubBot reports the issue as “Reason: Not Found (HTTP_404)” [2]. This means the link on the page for “Global Citizen of the Year”, leads to a 404 page (page not found).

Detail page with broken link issue details expanded and displaying location of broken link on the webpage

Step 3

FYI, when you clicked on the issue link to see more details, the location of the issue on the preview page was also highlighted. [3]

Step 4

The issue detail information displays a link for “Open in new window” [4]. This link opens the published page in a new browser tab in the same browser session.

Fix the broken link in WordPress

There are two quick options for opening WordPress to fix the broken link on your page:

Option 1: Click on the link for “Open in new window” (from Step 4), to open your webpage in a new browser tab in the same browser session.

Option 2: Click on the URL at the top of the details page to also open the webpage in a new browser tab in the same browser session.

URL to page with issue at the top of a detail page

For both of these options, if you are already logged in to WordPress, the WordPress toolbar will display at the top of the page. Clicking on “edit page” or “edit post” will open the block editor so that you can fix the broken link.

Tip

If you suspect that a broken link is a false positive, you can skip it, and the WordPress Support Team will take care of it in their next global review.

Fixing broken links

Navigate to a detail page