"use strict"; const {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0]; const {useMDXComponents: _provideComponents} = arguments[0]; function _createMdxContent(props) { const _components = { a: "a", code: "code", em: "em", h2: "h2", h3: "h3", hr: "hr", li: "li", ol: "ol", p: "p", pre: "pre", strong: "strong", table: "table", tbody: "tbody", td: "td", th: "th", thead: "thead", tr: "tr", ul: "ul", ..._provideComponents(), ...props.components }; return _jsxs(_Fragment, { children: [_jsxs(_components.p, { children: ["Once your ", _jsx(_components.a, { href: "/resources/guides/audit-site-ai-readiness", children: "audit" }), " identifies navigation failures, the next step is remediation. In most cases, these failures stem from structural issues rather than content quality. If your site is invisible to ", _jsx(_components.a, { href: "/resources/glossary/ai-agent", children: "AI agents" }), " despite having high-quality information, the architecture is likely the bottleneck."] }), "\n", _jsxs(_components.p, { children: ["This guide translates audit findings into concrete fixes. It is designed for the stage where you understand ", _jsx(_components.em, { children: "what" }), " is broken and need to know ", _jsx(_components.em, { children: "how" }), " to repair it. We move beyond generic advice to specific structural adjustments grounded in navigation research. Wayfinder's analysis of 3,348 navigation tasks across 269 websites reveals that 91% of successful navigation completes within two clicks. Beyond this threshold, the probability of an AI agent losing context increases significantly. The following sections outline the six most common structural blockers and the practical steps to resolve them."] }), "\n", _jsx(_components.h2, { children: "The Common Structural Problems" }), "\n", _jsx(_components.p, { children: "Understanding the failure patterns is the prerequisite for fixing them. The research highlights specific structural configurations that consistently confuse AI agents. These are not theoretical risks but observed failure modes from real-world navigation attempts." }), "\n", _jsx(_components.h3, { children: "Problem 1: Deep Navigation (3+ clicks to critical content)" }), "\n", _jsx(_components.p, { children: "AI agents traverse sites by clicking links. Each click compounds the likelihood of error. Wayfinder's research shows that 91% of successful navigation completes within two clicks. When critical pages sit three or more clicks away from the homepage, agents often time out or abandon the task." }), "\n", _jsxs(_components.p, { children: ["Symptoms of this issue include complex chains like ", _jsx(_components.code, { children: "Home > Solutions > Pricing > Plans" }), " or ", _jsx(_components.code, { children: "Home > Company > About > Team > Contact" }), ". In an enterprise site structure, the Contact page might sit 4 clicks deep, while Pricing is 3 clicks deep. This depth forces the agent to maintain context through multiple transitions, increasing the chance of a broken session. If your audit shows critical conversion paths exceeding two clicks, they are structurally vulnerable."] }), "\n", _jsx(_components.h3, { children: "Problem 2: Ambiguous Link Text (\"Solutions-Speak\")" }), "\n", _jsxs(_components.p, { children: ["Enterprise and B2B sites frequently collapse on hard tasks due to vague navigation labels. AI agents rely on ", _jsx(_components.a, { href: "/resources/glossary/semantic-search", children: "semantic matching" }), " to predict where a link leads. Labels like \"Platform\", \"Capabilities\", or \"Transformation\" offer no clear semantic signal."] }), "\n", _jsx(_components.p, { children: "Consider the label \"Platform\". It could lead to a feature overview, a technical architecture document, or a landing page. An agent cannot disambiguate this intent. Conversely, labels like \"Pricing\", \"Features\", or \"Documentation\" are unambiguous. They match the specific query intent of the agent. When an audit flags \"solutions-speak\" as a blocker, it means the labels do not map to the user's semantic query." }), "\n", _jsx(_components.h3, { children: "Problem 3: Multiple Links to Same Page (Loop Confusion)" }), "\n", _jsxs(_components.p, { children: ["Redundancy is helpful for humans but hazardous for AI. Sites often link to the same destination with different anchor text across headers, footers, and sidebars. Examples include \"Features\", \"Our Features\", and \"What We Offer\" all pointing to ", _jsx(_components.code, { children: "/features" }), "."] }), "\n", _jsx(_components.p, { children: "In Wayfinder's research, loop-related issues contribute heavily to navigation failures. AI agents may treat these as distinct options, attempting to navigate to each one sequentially. This creates a navigation loop where the agent visits the same page multiple times under different labels, consuming its context window without progressing. A site might have \"Pricing\", \"Plans\", and \"Investment Options\" all resolving to the same URL. This duplication creates false paths that distract the agent from the primary navigation tree." }), "\n", _jsx(_components.h3, { children: "Problem 4: Navigation Hidden in JavaScript or Footer Only" }), "\n", _jsx(_components.p, { children: "AI agents prioritise the main navigation menu. Research indicates that agents click header/nav links 80% of the time, largely ignoring footer or body content links unless explicitly directed there. If your critical navigation lives only in the footer or requires JavaScript execution to render, the agent misses it." }), "\n", _jsx(_components.p, { children: "This is common in single-page applications (SPAs) where navigation relies on client-side routing. If the navigation menu is not present in the initial DOM or requires a specific interaction to reveal, the agent cannot discover it. The hierarchy exists in the code but not in the navigation path the agent follows." }), "\n", _jsx(_components.h3, { children: "Problem 5: Homepage Doesn't Represent Site" }), "\n", _jsx(_components.p, { children: "The homepage is the primary anchor for AI discovery. Wayfinder's data shows 76% of homepage-first navigation succeeds, provided the homepage clearly represents the site's structure. However, many modern sites default to hero images with a single \"Learn More\" call-to-action." }), "\n", _jsx(_components.p, { children: "This design leaves the agent stranded. If the homepage does not expose the main navigation categories above the fold, the agent has no starting point. It cannot infer the site's taxonomy from a banner image. The homepage must function as a table of contents, explicitly linking to the key sections of the site rather than hiding them behind generic CTAs." }), "\n", _jsx(_components.h3, { children: "Problem 6: Infinite Scroll or Lazy-Loaded Content" }), "\n", _jsx(_components.p, { children: "Dynamic content loading is a standard feature for user experience but a blocker for AI. AI agents generally cannot trigger \"load more\" buttons or scroll events to reveal subsequent content. They only see the initial batch of items loaded on page render." }), "\n", _jsx(_components.p, { children: "If your listing pages rely on infinite scroll, the agent cannot access items beyond the first page. Pagination links must be static and visible. Without them, the site structure appears incomplete, and content deep within the list remains invisible to the agent." }), "\n", _jsx(_components.h2, { children: "Fixes by Problem" }), "\n", _jsx(_components.p, { children: "Fixing navigation requires a combination of architectural flattening and semantic clarification. The goal is to align the site structure with how AI agents traverse the web: linear, semantic, and shallow." }), "\n", _jsx(_components.h3, { children: "Fix 1: Flatten Navigation" }), "\n", _jsx(_components.p, { children: "The immediate objective is to bring critical pages to one or two clicks from the homepage. Identify your top 5-10 pages by conversion value (pricing, contact, core products). These must be accessible directly from the main navigation." }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "Before:" }) }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-text", children: "Home > Solutions > Enterprise Products > Software > [product]\nHome > Company > Contact\n" }) }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "After:" }) }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-text", children: "Home > Products (direct link in header)\nHome > Pricing (direct link in header)\nHome > Contact (direct link in header)\nHome > Solutions (submenu for categories if needed)\n" }) }), "\n", _jsx(_components.p, { children: "Move secondary content deeper, but keep the primary path shallow. This does not require deleting content, but rather exposing key entry points at the top level." }), "\n", _jsx(_components.h3, { children: "Fix 2: Clarify Navigation Labels" }), "\n", _jsx(_components.p, { children: "Audit your navigation labels against semantic clarity. Replace vague marketing terms with standardised, unambiguous equivalents. Test each label: would a non-expert understand where this link leads without guessing?" }), "\n", _jsxs(_components.table, { children: [_jsx(_components.thead, { children: _jsxs(_components.tr, { children: [_jsx(_components.th, { children: "Bad Label" }), _jsx(_components.th, { children: "Good Label" }), _jsx(_components.th, { children: "Reasoning" })] }) }), _jsxs(_components.tbody, { children: [_jsxs(_components.tr, { children: [_jsx(_components.td, { children: "Capabilities" }), _jsx(_components.td, { children: "Features" }), _jsx(_components.td, { children: "\"Capabilities\" is ambiguous." })] }), _jsxs(_components.tr, { children: [_jsx(_components.td, { children: "Platform" }), _jsx(_components.td, { children: "Product" }), _jsx(_components.td, { children: "\"Product\" clarifies the intent." })] }), _jsxs(_components.tr, { children: [_jsx(_components.td, { children: "Solutions" }), _jsx(_components.td, { children: "Pricing or Features" }), _jsx(_components.td, { children: "\"Solutions\" alone is too vague." })] }), _jsxs(_components.tr, { children: [_jsx(_components.td, { children: "Get Started" }), _jsx(_components.td, { children: "Book Demo" }), _jsx(_components.td, { children: "Be specific about the action." })] }), _jsxs(_components.tr, { children: [_jsx(_components.td, { children: "Transformation" }), _jsx(_components.td, { children: "[Specific Outcome]" }), _jsx(_components.td, { children: "Avoid abstract marketing speak." })] })] })] }), "\n", _jsx(_components.p, { children: "If your site serves multiple industries, create specific landing pages like \"Industries > Healthcare\" rather than burying them under a general \"Solutions\" tab. This allows the agent to navigate by sector directly." }), "\n", _jsx(_components.h3, { children: "Fix 3: Remove Link Duplication" }), "\n", _jsx(_components.p, { children: "Consolidate links that point to the same destination. While redundancy helps human memory, it creates noise for AI. Audit your header, footer, and sidebars to identify duplicates." }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "Before:" }) }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-html", children: "\n" }) }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "After:" }) }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-html", children: "\n\n" }) }), "\n", _jsx(_components.p, { children: "If you must keep multiple labels for UX reasons, ensure they lead to distinct sections or use one label as the primary navigation path and others as content links." }), "\n", _jsx(_components.h3, { children: "Fix 4: Put Navigation in Header" }), "\n", _jsx(_components.p, { children: "Ensure critical links are in the static header or a persistent sidebar. AI agents expect navigation to be in the header. Moving links from footer-only to header-only improves discoverability significantly." }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "Before:" }) }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-text", children: "Main nav: Home, About\nFooter nav: Pricing, Contact, Support\n" }) }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "After:" }) }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-text", children: "Main nav: Home, Pricing, Contact, Features, Support\nAbout: Secondary section or removed from primary nav\n" }) }), "\n", _jsx(_components.p, { children: "This guarantees that the agent encounters these links immediately upon parsing the DOM. If you use a dropdown menu, ensure the items within it are crawlable static links, not JavaScript-dependent overlays that may not render." }), "\n", _jsx(_components.h3, { children: "Fix 5: Make Homepage Navigation Clear" }), "\n", _jsx(_components.p, { children: "Redesign the homepage to function as a sitemap. The first screen must display the navigation menu or direct links to top-level categories. Avoid hero images that push navigation below the fold without visible links." }), "\n", _jsxs(_components.p, { children: [_jsx(_components.strong, { children: "Bad:" }), " Hero image + \"Learn More\" button.\n", _jsx(_components.strong, { children: "Good:" }), " Clear nav menu + section links for Products, Pricing, and Industries."] }), "\n", _jsx(_components.p, { children: "This ensures the agent establishes a map of the site immediately. If the agent cannot find the navigation on the homepage, it will struggle to build a context graph for the rest of the site." }), "\n", _jsx(_components.h3, { children: "Fix 6: Avoid Infinite Scroll" }), "\n", _jsx(_components.p, { children: "Replace infinite scroll with static pagination or a \"View All\" link. AI agents cannot execute the JavaScript required to load subsequent content blocks." }), "\n", _jsxs(_components.ol, { children: ["\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Use Pagination:" }), " Ensure ", _jsx(_components.code, { children: "" }), " links exist for page 1, page 2, etc."] }), "\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "View All Link:" }), " Provide a link to a static page containing all items."] }), "\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Category Links:" }), " For listing pages, provide clear links to all parent categories so the agent can navigate up the hierarchy."] }), "\n"] }), "\n", _jsx(_components.p, { children: "This ensures the entire content inventory is accessible without interaction." }), "\n", _jsx(_components.h2, { children: "Industry-Specific Guidance" }), "\n", _jsx(_components.p, { children: "Different industries face unique constraints that affect navigation structure. A fix that works for a blog may break a regulated enterprise site. Acknowledge these constraints when implementing changes." }), "\n", _jsx(_components.h3, { children: "Enterprise/B2B (Highest Failure Risk)" }), "\n", _jsx(_components.p, { children: "Enterprise sites often suffer from complex product lines and \"solutions-speak\". Regulatory compliance and multiple buyer personas lead to deep hierarchies." }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "Fixes:" }) }), "\n", _jsxs(_components.ol, { children: ["\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Adopt plain language:" }), " Ruthlessly replace terms like \"Transform\" or \"Accelerate\" with \"Product\", \"Pricing\", or \"Features\"."] }), "\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Separate product from use case:" }), " Create distinct pages for \"Product A\" and \"Use Case: Financial Compliance\". Do not merge them into a single complex URL structure."] }), "\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Direct industry links:" }), " Instead of ", _jsx(_components.code, { children: "Solutions > Financial Services > Payments" }), ", use ", _jsx(_components.code, { children: "Industries > Financial Services" }), ". This reduces click depth for sector-specific queries."] }), "\n"] }), "\n", _jsx(_components.h3, { children: "E-commerce (Stable, but Specific Issues)" }), "\n", _jsx(_components.p, { children: "E-commerce sites generally have better structure but face challenges with large catalogs and faceted search." }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "Fixes:" }) }), "\n", _jsxs(_components.ol, { children: ["\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Breadcrumb navigation:" }), " Breadcrumbs are critical. They explicitly signal ", _jsx(_components.code, { children: "Product > Category > Subcategory" }), " to the agent, helping it understand hierarchy."] }), "\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Faceted search:" }), " Ensure faceted navigation does not rely solely on JavaScript. URLs should reflect the filter state so the agent can crawl filtered views."] }), "\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Standalone product pages:" }), " Ensure pricing and availability are visible without requiring navigation through the site. The product page must be self-sufficient."] }), "\n"] }), "\n", _jsx(_components.h3, { children: "SaaS (Feature Complexity)" }), "\n", _jsx(_components.p, { children: "SaaS products struggle with feature bloat. Often, all features are compressed into one \"Products\" page, which confuses agents looking for specific capabilities." }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "Fixes:" }) }), "\n", _jsxs(_components.ol, { children: ["\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Documentation separation:" }), " Keep ", _jsx(_components.code, { children: "/docs" }), " separate from the product app. Do not bury documentation in the application login flow."] }), "\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Dedicated feature pages:" }), " Create one page per feature. Do not explain all features on a single overview page."] }), "\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Clear Pricing:" }), " Ensure ", _jsx(_components.code, { children: "/pricing" }), " is distinct from the signup flow. Agents looking for cost data should not have to create an account to access it."] }), "\n"] }), "\n", _jsx(_components.h3, { children: "Content/Media (Deep Archives)" }), "\n", _jsx(_components.p, { children: "Content sites often have deep archive structures that are difficult to navigate programmatically." }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "Fixes:" }) }), "\n", _jsxs(_components.ol, { children: ["\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Top-level categories:" }), " Ensure top-level categories are accessible from the homepage without scrolling."] }), "\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Topical navigation:" }), " Date-based hierarchies (", _jsx(_components.code, { children: "2024 > March" }), ") are harder for agents to understand than topical ones (", _jsx(_components.code, { children: "Topic > Subtopic" }), "). Prioritise topical links."] }), "\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Internal linking:" }), " Link related articles within the body text. This helps the agent traverse the archive structure via context rather than just the main menu."] }), "\n"] }), "\n", _jsx(_components.h3, { children: "Healthcare/Pharma (Regulatory Constraints)" }), "\n", _jsx(_components.p, { children: "Compliance requirements often create interstitials and disclaimers that gate content." }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "Fixes:" }) }), "\n", _jsxs(_components.ol, { children: ["\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Content first:" }), " Place disclaimers after key content, not before. The agent must see the information first."] }), "\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Language paths:" }), " If multiple languages are required, use URL paths (", _jsx(_components.code, { children: "/en/" }), ", ", _jsx(_components.code, { children: "/fr/" }), ") rather than JavaScript detection."] }), "\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Simplify consent:" }), " Do not gate core content behind multiple consent screens. Allow crawlers to access content without interaction where possible."] }), "\n"] }), "\n", _jsx(_components.h2, { children: "Priority Framework" }), "\n", _jsx(_components.p, { children: "Not all fixes carry equal weight. A site with thousands of pages cannot be restructured overnight. Prioritise changes based on impact and effort." }), "\n", _jsx(_components.h3, { children: "Highest Impact (Do First)" }), "\n", _jsx(_components.p, { children: "Focus on the blockers that cause immediate navigation failure." }), "\n", _jsxs(_components.ul, { children: ["\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Flatten navigation:" }), " Get critical pages to 2 clicks or less. This addresses the 91% success window observed in Wayfinder's research."] }), "\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Clarify link labels:" }), " Replace \"solutions-speak\" with semantic terms. This fixes the disambiguation problem."] }), "\n", _jsxs(_components.li, { children: [_jsxs(_components.strong, { children: ["Fix ", _jsx(_components.a, { href: "/resources/glossary/robots-txt-ai", children: "robots.txt" }), ":"] }), " Ensure your robots.txt file is not blocking the navigation crawlers that AI agents rely on."] }), "\n"] }), "\n", _jsx(_components.h3, { children: "Medium Impact" }), "\n", _jsx(_components.p, { children: "These improvements support long-term discoverability but do not cause immediate failure." }), "\n", _jsxs(_components.ul, { children: ["\n", _jsxs(_components.li, { children: [_jsxs(_components.strong, { children: ["Add ", _jsx(_components.a, { href: "/resources/glossary/schema-markup", children: "schema markup" }), ":"] }), " Helps agents understand the relationships between pages."] }), "\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Fix JavaScript rendering:" }), " Ensure critical content is visible in the initial DOM."] }), "\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Remove link duplication:" }), " Reduces noise in the navigation graph."] }), "\n"] }), "\n", _jsx(_components.h3, { children: "Lower Impact" }), "\n", _jsx(_components.p, { children: "These are nice-to-haves for optimal performance but not essential for basic access." }), "\n", _jsxs(_components.ul, { children: ["\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Breadcrumbs:" }), " Helpful for context but not critical if the nav is flat."] }), "\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Footer optimisation:" }), " AI rarely uses footer links for primary navigation."] }), "\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Advanced patterns:" }), " Complex mega-menus or dynamic interactions often introduce more risk than value."] }), "\n"] }), "\n", _jsx(_components.hr, {}), "\n", _jsxs(_components.p, { children: ["Implementing these fixes improves your site's resilience against AI discovery challenges. If you have implemented these structural adjustments, verify the results. Run a ", _jsx(_components.a, { href: "/compass", children: "Compass audit" }), " to measure how much ", _jsx(_components.a, { href: "/resources/glossary/ai-navigability", children: "AI navigation" }), " has improved and identify any remaining gaps in your architecture."] }), "\n", _jsxs(_components.p, { children: ["To begin understanding why these structures matter, review the foundational principles of ", _jsx(_components.a, { href: "/resources/guides/how-ai-agents-navigate-websites", children: "how AI agents navigate websites" }), ". If you have not yet assessed your current readiness, start with a ", _jsx(_components.a, { href: "/resources/guides/audit-site-ai-readiness", children: "site audit" }), " to identify specific navigation blockers."] })] }); } function MDXContent(props = {}) { const {wrapper: MDXLayout} = { ..._provideComponents(), ...props.components }; return MDXLayout ? _jsx(MDXLayout, { ...props, children: _jsx(_createMdxContent, { ...props }) }) : _createMdxContent(props); } return { default: MDXContent };

Fixing Your Site Structure for AI Navigation: Common Problems and Practical Solutions