---
name: internal-linking
description: Find orphan and weakly linked pages and add descriptive internal links so crawlers find and understand every important page. Use when pages are not indexed, when a new page gets no traffic, or when a user asks for an internal linking plan.
---

# Internal linking

## Facts to use
- Google finds pages through links. It can follow links that are `<a>` elements with an `href` attribute. Links made only with JavaScript click handlers may not be followed.
- Anchor text helps Google understand the target page. Use descriptive text, not "click here".
- Every page you want indexed should have at least one link from another page on the site.

## Workflow
1. Crawl the site from the home page. Export, per URL: inbound internal links, the anchor texts used, and click depth from the home page.
2. Compare with the sitemap. A URL in the sitemap with zero inbound links is an orphan.
3. For each important page with few inbound links, find 3 to 5 pages on the same topic that should link to it.
4. Add links inside the body text where the topic comes up, with anchor text that names the target page's topic.
5. Add hub pages for groups of related pages (for example a guides index) and link each child page from the hub and back.
6. Fix links that point to redirects or 404s so they point straight to the final URL.

## Checks
- [ ] No orphan pages among indexable URLs.
- [ ] Important pages are at most three clicks from the home page.
- [ ] Links are `<a href>` in the raw HTML.

## Output
A table: target URL, current inbound links, source page to add, anchor text, sentence where the link goes.

## Sources
- Google: Understand JavaScript SEO basics (links need <a href>). https://developers.google.com/search/docs/crawling-indexing/javascript/javascript-seo-basics
