July 15, 2026 - Site source navigation warnings
Find unresolved navigation page targets without blocking valid source sync and deploy workflows.
Site source validation now reports an enabled navigation page_key that does not resolve to an enabled page-registry entry as a classified warning.
Affected surfaces
- Developer API
- CLI
- Docs
Changes
- Validation responses include
theme_navigation_target_missinginwarnings[]with navigation category, warning severity, parameter path, and source context. - Nested navigation items are checked using registry paths declared by the theme; arbitrary URL links are not treated as page-registry targets.
- Warnings leave
valid=trueand do not block source save, preview, package, deploy, or owner-gated publication. - The CLI prints warnings to stderr and continues without an interactive confirmation. Validation errors remain blocking.
Developer action
Review warnings and either add/enable the target page-registry entry or remove the stale navigation target. No client migration is required.
See Website source workflow and Website source with the CLI.