---
name: "fix-internal-links-orphan-pages-method"
description: "Use when you need to Fix internal links and orphan pages on your site. List pages, count links, choose hubs and fix orphans before you publish"
---

# List pages, count links, choose hubs and fix orphans before you publish

Job: [Fix internal links and orphan pages on your site](https://aiagents.org/canai/fix-internal-links-orphan-pages)

## Need

- ai agent

## Steps

1. List every page. Paste the prompt. The agent combines the sitemap with a crawl, because pages that nothing links to are often missing from one of them.
2. - Check: The list includes pages you forgot you published.
3. Count links per page. The agent counts the links that point at each page. Links in the main text matter most. A page linked only from the footer is close to an orphan.
4. - Check: You see a table of links in and links out per page.
5. Tag the pages. Confirm or change the agent's tags. Money pages sell or convert. Supporting pages answer related questions. Low-value pages may need a merge, a redirect or no action.
6. - Check: Every page has one tag that you approved.
7. Choose one hub per topic. For each group of related pages, pick the page that best covers the topic. Supporting pages link to it, and it links to the money page.
8. - Check: Each topic has one hub.
9. Settle pages that compete. If two pages target the same query, pick one to own it. Link the other one to it, or merge them with a redirect.
10. - Check: Each important query has one owner page.
11. Review the proposed links in context. Read each new link in its sentence. Reject links that interrupt the reader or point to a page the reader does not need next. Use anchor text that describes the target page.
12. - Check: Each approved link reads naturally.
13. Apply, then crawl again. The agent adds the approved links. Run the crawl again and compare the counts.
14. - Check: No important page is an orphan, and the hubs gained links.
15. Set the rule for new posts. Write a rule into your publishing checklist. For example, every new post links to its hub and to two related posts, and gets links from at least three existing pages.
16. - Check: The rule is written where you and your agent will see it.
17. Note: Steps quoted from Agents Handbook (CC BY 4.0). A person still reviews every proposed link before publish.

## Credit

Method author Agents Handbook (CC BY 4.0)
Source: https://agentshandbook.com/p/fix-internal-links-and-orphan-pages