Repository navigation
Error Codes seo
github-actions[bot] edited this page Nov 16, 2026
·
2 revisions
Part of Error codes: every code @ultimat3/seo registers. x errors explain <CODE> --json prints the same row.
| Code | Means | Typical cause | Fix |
|---|---|---|---|
X_IMAGE_QUERY_INVALID |
a minted image URL's ?w=/?q= value is present but unusable |
?w=0, ?w=-5, ?q=150 on a URL responsiveImage() minted |
request a positive integer, e.g. ?w=640 (quality is 1-100, e.g. ?q=75) |
X_LD_INVALID |
JSON-LD node is missing a required schema.org field | an ld.* helper called with a partial object |
supply the field named in cause
|
X_SEO_CANONICAL_MISMATCH |
canonical URL does not match the route path | a hand-written canonical | delete it — canonicals come from the route table |
X_SEO_DUPLICATE_META |
two routes share a title or description | copied metadata | make each page's meta unique |
X_SEO_LINK_INVALID |
a route meta link is unsafe or would fetch nothing | a javascript:/data: href, a preload with no as, or a font preload with no crossorigin |
meta: { links: [{ rel: 'preload', href: '/assets/…', as: 'font', crossorigin: 'anonymous' }] } in the route's defineRoute(): an http(s) or relative href, as on every preload, crossorigin on a font preload |
X_SEO_LLMS_DESCRIPTION_MISSING |
a page listed in llms.txt has no description | seo.llms is on and an indexable site/ route resolves a meta with no description, so its llms.txt line would say nothing about the page |
x verify --only seo --json — then add meta.description to the route file it names, or set seo: { llms: false } in app.config.ts |
X_SEO_META_MISSING |
a site/ route is missing required metadata |
no title, description or og.image
|
add it to meta; the file is named in cause
|
X_SEO_META_TOO_LONG |
title or description exceeds what results render | a description over 160 chars |
meta: { description: '<at most 160 characters>' } — shortened; cause carries the measured length |
X_SEO_OG_IMAGE_CONFLICT |
a route meta og declares both image and capture | meta.og carries both image and capture (a cast or a JS caller past the type), so the static export publishes the capture and a served page publishes no og:image at all |
og: { image: '/card.png' } or og: { capture: '/og/<page>' }, never both, in the route file's defineRoute({ meta })
|
X_SITEMAP_ENTRY_INVALID |
a sitemap entry carries a lastmod or a locale the sitemap cannot write | a prerender() entry (or a page handed to buildSitemap) has a lastmod that is not an ISO 8601 date with an explicit zone, or names a locale the app does not route |
x verify --json after prerender() in the route file named in cause answers lastmod as a Date or an ISO 8601 string with a zone (row.updatedAt) and only routed locales in locales
|
X_SITEMAP_TOO_LARGE |
sitemap exceeds the 50,000-entry limit | too many prerendered URLs in one file | enable sitemap index splitting in app.config.ts
|
Ultimate — v31.43.0 As of 2026-10. The full-stack framework where the primary developer is an AI agent: bunx create-ultimate myapp → Getting started · live demo. MIT licensed. What npm serves is npm view @ultimat3/core version, never this line, and this footer is the only page that stamps a version.
Repository · Issues · Changelog · llms.txt
Edits to these pages are synced from wiki/ in the repository — change the file there, not the wiki, or the next sync overwrites it.
Start
- Getting started
- Installation
- Shapes
- Bare VM
- Project layout
- Migrating an existing app
- Compared to other stacks
Tutorials
- 1 · First app
- 2 · First feature
- 3 · Auth and admin
- 4 · Jobs and realtime
- 5 · Deploy free
- 6 · Growing up
Primitives
- The eight primitives
- Building your own base
- Actions
- Entities and migrations
- Policies and authz
- Queries and live queries
- Client data
- Jobs and workflows
- Scheduled tasks
- Routes and render modes
Capabilities
- Realtime
- Caching and invalidation
- Batching and preloading
- N+1 detection
- PWA and offline
- Client navigation
- MCP and AI
- Agents
- Admin dashboard
- Scraping
- Auth
- Notify
- Storage and uploads
- Feature flags
- SEO
- Static assets
Cross-cutting
- I18n
- Theming
- UI components
- Interface rules
- Timezones and dates
- Money
- Outbound HTTP
- Resource management
- Migrations and backfills
- Testing
- CI: the gate across parallel jobs
Reference