general site-architecture-seo

site-architecture-seo

This skill should be used when the user asks to "design site architecture for SEO", "URL structure for SEO", "plan site structure", "information architecture for SEO", "organize site for search", "site hierarchy for SEO", "plan URL structure", "website structure for ranking", or any variation of designing, planning, or optimizing website architecture, URL structure, and site hierarchy for SEO performance.
Download .md

Site Architecture for SEO

Site architecture is how your pages are organized, connected, and accessed. Good architecture makes every page discoverable by search engines and reachable by users within 3 clicks. Bad architecture buries pages, wastes crawl budget, and fragments topical authority across disconnected sections.

For SaaS sites, architecture matters most when you scale past 50 pages. A 20-page site doesn't need complex architecture. A 200-page site with blog posts, comparison pages, glossary terms, integration pages, and pSEO content absolutely does.

The SaaS Site Architecture Model

URL hierarchy

yourdomain.com/
├── /product/              → Product pages, feature pages
├── /pricing/              → Pricing page
├── /vs/                   → Comparison pages ([you] vs [competitor])
│   ├── /vs/hubspot-vs-salesforce
│   └── /vs/hubspot-vs-pipedrive
├── /alternatives/         → Alternatives pages ([competitor] alternatives)
│   └── /alternatives/salesforce-alternatives
├── /blog/                 → Blog posts
├── /guides/               → Long-form guides and how-tos
├── /glossary/             → Glossary / definition pages
│   └── /glossary/lead-scoring
├── /integrations/         → Integration pages
│   └── /integrations/salesforce
├── /use-cases/            → Use case pages
│   └── /use-cases/saas-sales-teams
├── /customers/            → Case studies
│   └── /customers/acme-corp
├── /resources/            → Resource hub (links to guides, reports, tools)
└── /changelog/            → Product changelog

URL rules

Rule Bad Good
Lowercase only /Blog/Lead-Scoring /blog/lead-scoring
Hyphens between words /blog/lead_scoring or /blog/leadscoring /blog/lead-scoring
Descriptive, keyword-rich /page?id=42 /vs/hubspot-vs-salesforce
Short and clean /blog/2026/01/15/the-complete-guide-to-lead-scoring-for-b2b /guides/lead-scoring
No trailing slashes (or always trailing — be consistent) Mix of /blog/post and /blog/post/ Pick one convention and enforce it
No parameters for content /blog?category=seo&page=2 /blog/seo/ for category pages
Subfolder for content types All pages under root / /vs/, /blog/, /glossary/ for each type

Hub-and-Spoke Architecture

The most effective architecture for SaaS SEO is hub-and-spoke: hub pages link to related spoke pages, and spoke pages link back to the hub.

How it works

Hub: /guides/lead-scoring (comprehensive guide)
├── Spoke: /glossary/lead-scoring (definition)
├── Spoke: /blog/lead-scoring-best-practices (how-to)
├── Spoke: /vs/hubspot-lead-scoring-vs-salesforce (comparison)
├── Spoke: /blog/lead-scoring-mistakes (common mistakes)
└── Spoke: /product/lead-scoring (product feature page)

Benefits:

  • Google understands topical relationships between pages
  • Authority flows from hub to spokes and back
  • Users navigate naturally between related content
  • Topic clusters build topical authority for the entire group

Hub page requirements

Requirement Why
Comprehensive coverage of the topic Hub must be the definitive page on the topic
Links to every spoke page Hub distributes authority and helps crawling
Linked from the main navigation or resources page Hub must be easily discoverable
2,000-4,000 words Long enough to cover the topic comprehensively
Updated regularly Hub freshness signals apply to the entire cluster

Spoke page requirements

Requirement Why
Covers one subtopic in depth Each spoke targets a specific keyword cluster
Links back to the hub page Returns authority to the hub
Links to 1-2 other relevant spokes Cross-links strengthen the cluster
Targets a specific keyword Each spoke has its own primary keyword

Internal Linking Rules

Rule Implementation
Every page links to 3-5 related pages Add contextual links within body content
Use descriptive anchor text "Learn how to set up lead scoring in HubSpot" not "click here"
Link from high-authority pages to important new pages New comparison page? Link to it from your homepage or highest-traffic blog post
No orphan pages Every page must be linked from at least one other page
Priority pages within 2 clicks of homepage Comparison pages, pricing, and product pages accessible from main nav
Hub pages linked from main navigation /resources or /guides in the header nav
Breadcrumbs on every page Shows hierarchy: Home > Guides > Lead Scoring

Architecture for Scale (pSEO)

When you have 100+ programmatic pages, architecture prevents them from becoming an unindexable mass.

Architecture element Purpose Example
Category hub pages Group related pSEO pages /integrations/ (hub listing all integrations)
Pagination or load-more Make all pages crawlable /integrations/page/2 or infinite scroll with proper implementation
Internal cross-links Connect related pSEO pages Integration page for Salesforce links to integration page for HubSpot
XML sitemap for pSEO Ensure all pages are discoverable by crawlers Separate sitemap for /integrations/ pages
Faceted navigation (if applicable) Let users filter without creating duplicate URLs Canonical tags on filtered views

Architecture Audit

Check How Pass criteria
Crawl depth Screaming Frog → Crawl Depth 95% of pages within 3 clicks of homepage
Orphan pages Screaming Frog → Orphan Pages Zero orphan pages for important content
Internal links per page Screaming Frog → Internal Links Average 5+ internal links per page
URL consistency Screaming Frog → URL report Consistent format (lowercase, hyphens, no trailing slash or always trailing slash)
Breadcrumb implementation Manual check on 5 pages Breadcrumbs present and correct on all pages
Hub pages exist Manual check Hub page exists for every major topic cluster
Navigation includes priority pages Manual check Comparison, pricing, product pages in main nav within 1-2 clicks
XML sitemap completeness Compare sitemap to crawled pages All important pages in sitemap

Pre-Design Checklist

  • [ ] Content inventory completed (all current and planned page types listed)
  • [ ] URL naming convention defined and documented
  • [ ] Hub-and-spoke clusters planned for top 5 topics
  • [ ] URL hierarchy mapped (with example URLs per content type)
  • [ ] Main navigation structure defined (priority pages within 1-2 clicks)
  • [ ] Internal linking rules documented
  • [ ] Breadcrumb structure defined
  • [ ] pSEO architecture planned (if applicable: hub pages, sitemaps, cross-links)
  • [ ] XML sitemap auto-generation configured
  • [ ] Canonical tag strategy defined
  • [ ] Architecture audit baseline completed (crawl depth, orphan pages, internal links)

Anti-Pattern Check

  • All pages under /blog/ regardless of type → Comparison pages, glossary terms, and how-to guides are not blog posts. Use distinct URL paths: /vs/, /glossary/, /guides/. This helps Google understand content types and helps users navigate
  • No hub pages → Without hub pages, your topic clusters are a collection of disconnected pages. Build a comprehensive hub page for every major topic and link all related pages to it
  • Important pages buried 5+ clicks deep → If Google has to crawl through 5 levels to reach your best comparison page, it may not crawl it at all. Keep priority pages within 2-3 clicks of the homepage
  • Orphan pages (linked from nowhere) → Orphan pages can't be crawled and won't rank. Every page must be linked from at least one other page. Check with Screaming Frog after every publish
  • Inconsistent URL format → Mixing /blog/lead_scoring, /Blog/Lead-Scoring, and /blog/lead-scoring/ creates confusion and potential duplicate content. Pick one convention and enforce it site-wide
  • No breadcrumbs → Breadcrumbs help Google understand hierarchy and give users navigation context. Add BreadcrumbList schema to every page
Want agents that use skill files like this?
We customize skill files for your brand voice and methodology, then run content agents against them.
Book a call