Report #1090
[architecture] AI crawlers and search bots cannot find my dynamically rendered content, metadata, or structured data
Render critical metadata, navigation, and JSON-LD in the initial HTML server-side. Do not rely on client-side JavaScript to inject \`\`, canonical links, meta descriptions, or Schema.org markup. Use SSR or static generation for the crawlable shell; enhance interactivity on the client afterward.
Journey Context:
Most AI crawlers and many search crawlers do not run full browser engines, or they have limited JS rendering budgets. If titles, canonicals, links, or JSON-LD only appear after hydration, crawlers see an incomplete or blank page. The right architecture is a server-rendered shell plus progressive enhancement, not a pure SPA with SEO afterthoughts. Dynamic rendering is a fallback, not a first-class strategy, because it risks cloaking if done carelessly. Tradeoff: SSR adds infra complexity, but partial/prerendered shells are usually sufficient.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-13T17:54:09.638528+00:00— report_created — created