We respect your privacy.

We use strictly necessary cookies to keep you signed in and to protect against CSRF. With your permission we also use a small amount of first-party analytics to improve the product. We do not sell your data and we do not use third-party advertising trackers. See our cookie policy and privacy policy .

← All learn topics

Rule site.orphan-pages

Pages have no inbound internal links

site.orphan-pages is a check in Crawlmind's site audit that grades medium-impact issues of this kind. This page explains why the rule matters and the exact fix.

Impact: mediumEffort: lowFixable: 1-click

Why it matters

A page that no other page on the site links to is hard to discover. Search engines find it via the sitemap but assign it low PageRank because nothing on the site says "this matters." AI engines often skip orphan pages entirely because they read site hierarchy from the internal link graph and an orphan has no graph position. Most orphans are accidental: pages that got renamed without updating their inbound links, or one-off marketing landing pages that nobody linked to from the main nav.

The fix

Find orphans:

```sh
# every URL from the sitemap
curl -s https://example.com/sitemap.xml | grep -oE "<loc>[^<]+</loc>" | sed "s/<[^>]*>//g" > sitemap-urls.txt

# crawl, collect every internal href
wget -r -l 5 --spider https://example.com 2>&1 | grep -oE 'https://example.com/[^ ]*' | sort -u > linked-urls.txt

# orphans = sitemap minus linked
comm -23 <(sort sitemap-urls.txt) linked-urls.txt
```

Fix three ways depending on what the page is:

- **Genuinely useful but unlinked**: link to it from a relevant parent (a blog index, a docs sidebar, a category page). One inbound link is enough.
- **Outdated / replaced**: 301-redirect to the current equivalent. Remove from sitemap.
- **Test pages or stubs that shipped by mistake**: delete, 410, remove from sitemap.

Going forward: ensure your CMS or build pipeline auto-links new content from at least one index page (blog list, documentation TOC, sitemap UI). Orphans are rare on systems that do this; common on systems that don't.

References