Skip to main content
Detects pages with no internal links pointing to them
Rule IDlinks/orphan-pages
CategoryLinks
ScopeSite-wide
Severitywarning
Weight5/10

Solution

Orphan pages have no internal links and are hard for search engines to discover. They may not get indexed or rank well. Add internal links from relevant pages. Include in navigation or sidebar. Add to sitemap. Create contextual links from related content. If intentionally orphaned (e.g., landing pages), ensure they’re accessible via sitemap.

Options

This rule supports the following configuration options:
OptionTypeDefaultDescription
minInboundLinksunknownundefinedMinimum inbound links required (pages below this are flagged)
excludePatternsunknownundefinedURL patterns to exclude from orphan detection

Configuration Example

squirrel.toml
[rules."links/orphan-pages"]
minInboundLinks = undefined
excludePatterns = undefined

Enable / Disable

Disable this rule

squirrel.toml
[rules]
disable = ["links/orphan-pages"]
squirrel.toml
[rules]
disable = ["links/*"]

Enable only this rule

squirrel.toml
[rules]
enable = ["links/orphan-pages"]
disable = ["*"]