Finding Broken Links with the SEO Report

Broken links frustrate readers and hurt your search rankings. The SEO page crawls your published site and lists every link that doesn't work, plus every link that points to another website. This article also covers the settings that control how search engines index your site.

Open the SEO report

Click SEO in the left navigation. The page is titled Search Engine Optimization and has two tabs: Broken Links and Outbound Links. The results come from the most recent link audit.

On the Broken Links tab, click Run Link Audit. You'll see Audit queued. Broken links will update when the crawl completes. The crawl runs in the background and usually finishes within a few minutes, depending on the size of your site. Reload the page to see the new results.

The audit starts from your site's sitemap.xml, visits every published article, and checks every link it finds. A link counts as broken when it doesn't return a successful response, times out after 15 seconds, or fails to connect. Each audit replaces the previous results.

Refresh from Settings

Settings → Advanced → Refresh Internal Link Index runs the same crawl. Click Refresh Link Index there after a large reorganization. The crawl also rebuilds the index of which articles link to which, used for backlink tracking in the editor.

SEO page Broken Links tab listing links with status, type, URL and where they were found
The Broken Links report

The tab shows how many broken links were found, then lists them with links on your own site first:

ColumnShows
StatusThe HTTP status code the link returned, such as 404 or 500. Error means there was no response; hover over it to see why
TypeInternal for links to your own site, External for links to other sites
URLThe broken link
Found OnThe page that contains the link
Anchor TextThe linked text on that page

Click any URL, page or anchor text to copy it. Use the All Statuses menu to show one status code, and the All Types menu to show only Internal or External links. When nothing is broken, the tab shows No broken links found.

  1. Copy the Found On page and open it in the editor.
  2. Search the article for the Anchor Text and update or remove the link. See Working with Links.
  3. Publish your changes, then run the audit again to confirm the link is fixed.

If an internal link is broken because an article moved or was deleted, you can add a redirect from the old URL instead of editing every page that links to it. See Redirects and Page Not Found Reports.

This tab lists every link from your site to another website, one row for each page that contains it. It loads when you select the tab.

ColumnShows
DomainThe website the link points to
URLThe full link
FromThe page on your site that contains the link
KeywordThe linked text
FollowWhether search engines follow the link. Links marked rel="nofollow" show as not followed
StatusThe HTTP status code the link returned

Type in Filter by domain... to find links to a particular site, and click any column heading to sort. Use this tab to review which sites you link to and how often.

Control search engine indexing

For your whole site

Go to Settings → General and use Allow Search Engine Indexing, then click Update. It's off for new projects, so you can build your site before search engines find it. While it's off, your robots.txt disallows every page. Turn it on when you're ready to launch. Private projects are never indexed, whatever this setting says.

Project Settings General tab
Settings, General tab

For a single article

  1. Open a published article in the editor and click Advanced.
  2. On the SEO tab, turn off Allow Indexing.
Advanced Article Options SEO tab with Allow Indexing
The SEO tab

The article gets a noindex, nofollow robots tag, so search engines leave it out of their results. The option only appears for published articles; drafts, unlisted and scheduled articles always carry the noindex tag. The SEO tab is also where you set the article's Meta Description and Keywords.

Force Trailing Slash

By default, article URLs have no trailing slash, for example /article/my-post, and requests for /article/my-post/ are permanently redirected to it.

If you're moving from WordPress, your existing URLs probably end in a slash. Go to Settings → Advanced and turn on Force Trailing Slash. The change saves immediately. Article URLs then end in a slash, the version without the slash redirects to it, and your canonical tags, sitemap and feeds use the slash form. This keeps your old URLs and their search rankings intact.

Settings Advanced tab with Force Trailing Slash and Refresh Link Index
Settings, Advanced tab
Pick one and keep it

Changing this setting on an established site changes every article's canonical URL. Search engines follow the redirects, but it takes time for them to settle.