Fix: Config Contains Legacy Key in Astro
Config contains legacy key. Learn how to fix the legacy config key error when using deprecated configuration options.
Find solutions to common Astro errors, warnings, and build-time issues.
Config contains legacy key. Learn how to fix the legacy config key error when using deprecated configuration options.
Unable to resolve config file. Learn how to fix the config not found error when Astro cannot locate the configuration file.
Environment variables validation failed. Learn how to fix the invalid environment variables error when env variables fail schema validation.
Action returned invalid data. Learn how to fix the action returned invalid data error when action handlers return non-serializable data.
Could not load actions file. Learn how to fix the actions can'
Actions are not enabled because there is no server output configured. Learn how to fix the actions without server output error when using Astro actions without SSR.
Actions should be called from client-side code. Learn how to fix the action called from server error when incorrectly calling actions from server-side code.
Action not found. Learn how to fix the action not found error when calling an undefined or missing action.
Astro.glob() used outside of an Astro file. Learn how to fix the Astro.glob() used outside error when calling Astro.glob in non-.astro files.
Astro.glob() did not match any files. Learn how to fix the Astro.glob() no match error when the glob pattern does not find any files.
Could not import file. Learn how to fix the could not import file error when import paths are incorrect or files do not exist.
Invalid glob pattern. Learn how to fix the invalid glob pattern error when glob patterns do not start with the required prefixes.
Invalid prerender export. Learn how to fix the invalid prerender export error when using the prerender option incorrectly.
Invalid type returned by Astro page. Learn how to fix the invalid type error when a page returns something other than a Response object.
Module is only available server-side. Learn how to fix the server-only module error when importing server-only code in client-side scripts.
`Astro.clientAddress` is not available in current adapter. Learn how to fix the clientAddress not available error when the adapter does not support IP address detection.
Cannot use Server-side Rendering without an adapter. Learn how to fix the no adapter installed error when using SSR features without configuring a server adapter.
Cannot use Server Islands without an adapter. Learn how to fix the no adapter error when using Server Islands without configuring a server adapter.
`Astro.clientAddress` is not available in prerendered pages. Learn how to fix the clientAddress not available error when trying to access client IP in static/prerendered pages.
Content entry data does not match schema. Learn how to fix the content entry data error when data collection entries fail schema validation.
Collection contains entries of a different type. Learn how to fix the content collection type mismatch error when entries do not match the configured collection type.
Content entry frontmatter does not match schema. Learn how to fix the content frontmatter schema error when frontmatter data does not match the collection schema.
Content Schema should not contain `slug`. Learn how to fix the content schema contains slug error when the schema defines a reserved slug field.
Duplicate content entry slug. Learn how to fix the duplicate content entry slug error when multiple entries have the same slug.
Data collection entry failed to parse. Learn how to fix the data collection parse error when JSON, YAML, or TOML files have syntax errors.
Failed to generate content types. Learn how to fix the failed to generate content types error when astro sync fails to create collection types.
Invalid content entry slug. Learn how to fix the invalid content entry slug error when the slug field is not a valid string.
Content and data cannot be in same collection. Learn how to fix the mixed content data collection error when a collection contains both content and data entries.
Attempted to render an undefined content collection entry. Learn how to fix the render undefined entry error when calling render() on an undefined content entry.
Could not transform image. Learn how to fix the could not transform image error when image transformation fails due to corrupted or malformed files.
Expected src to be an image. Learn how to fix the expected image error when the src prop is not an imported image or valid URL string.
Image missing required "alt" property. Learn how to fix the missing alt property error when using the Image component without alt text for accessibility.
Image not found. Learn how to fix the image not found error when the image path in your code does not exist.
Error while loading image service. Learn how to fix the error while loading image service when image service configuration fails.
Local images must be imported. Learn how to fix the local images must be imported error when using string paths instead of imported images.
Missing image dimensions. Learn how to fix the missing image dimensions error when using remote images without width and height attributes.
Could not find Sharp. Learn how to fix the could not find Sharp error when the Sharp library is not installed for image optimization.
Unsupported image format. Learn how to fix the unsupported image format error when using image formats not supported by the configured image service.
The endpoint did not return a `Response`. Learn how to fix the endpoint error when it does not return a Response object.
Value assigned to `locals` is not accepted. Learn how to fix the locals error when assigning a non-object value to Astro.locals.
`locals` must not be reassigned. Learn how to fix the locals reassignment error when trying to replace the entire locals object.
The middleware didn' Learn how to fix the middleware error when it does not return a Response or call next().
Can' Learn how to fix the middleware loading error when the middleware file has errors or is misconfigured.
The middleware returned something that is not a `Response` object. Learn how to fix the middleware error when it returns a non-Response value.
Cannot use Astro.rewrite after the request body has been read. Learn how to fix the rewrite error when calling rewrite() after the request body has already been consumed.
`getStaticPaths()` function is required for dynamic routes. Learn how to fix the getStaticPaths() function required error when creating dynamic routes in Astro.
Missing params property on `getStaticPaths` route. Learn how to fix the missing params property error when getStaticPaths entries lack the required params object.
Invalid entry inside getStaticPath' Learn how to fix the invalid entry error when getStaticPaths returns non-object entries.
Invalid value for `getStaticPaths` route parameter. Learn how to fix the invalid route parameter error when params contain values other than strings, numbers, or undefined.
No static path found for requested path. Learn how to fix the no static path found error when a dynamic route matches but no path is returned from getStaticPaths.
Prerendered route generates the same path as another route. Learn how to fix the prerendered route conflict error when two routes generate identical static paths.
i18n Not Enabled. Learn how to fix the i18n not enabled error when using i18n features without configuration.
You can' Learn how to fix the i18n strategy error when using functions incompatible with your routing strategy.
Index page not found. Learn how to fix the missing index page error when the default locale redirect cannot find an index page.
The provided locale does not exist. Learn how to fix the missing locale error when using a locale not configured in i18n settings.
Enabled manual internationalization routing without having a middleware. Learn how to fix the missing middleware error when using manual i18n routing without a middleware file.
Invalid frontmatter injection. Learn how to fix the invalid frontmatter injection error when remark/rehype plugins inject invalid data.
Failed to parse Markdown frontmatter. Learn how to fix the markdown frontmatter parse error when YAML/TOML frontmatter has syntax errors.
MDX integration missing. Learn how to fix the MDX integration missing error when using MDX files without the @astrojs/mdx integration.
Missing value for `client:media` directive. Learn how to fix the missing value error when using client:media without a media query string.
No client entrypoint specified in renderer. Learn how to fix the no client entrypoint error when using client directives with renderers that lack client-side support.
Missing hint on client:only directive. Learn how to fix the missing hint error when using client:only without specifying the framework.
No matching renderer found. Learn how to fix the no matching renderer found error when using framework components without the proper integration.
Invalid slot name. Learn how to fix the reserved slot name error when using slot names that are reserved by Astro.
Session configuration is required. Learn how to fix the session config missing error when using sessions without proper configuration.
Failed to initialize session storage. Learn how to fix session storage initialization errors when the session driver fails to start.