Error reference
The following reference is a complete list of the errors you may encounter while using Astro. For additional assistance, including common pitfalls, please also see our Troubleshooting Guide.
Astro Errors
Section titled Astro Errors- UnknownCompilerError (E01000)
Unknown compiler error. - StaticRedirectNotAvailable (E03001)
Astro.redirect
is not available in static mode. - ClientAddressNotAvailable (E03002)
Astro.clientAddress
is not available in current adapter. - StaticClientAddressNotAvailable (E03003)
Astro.clientAddress
is not available in static mode. - NoMatchingStaticPathFound (E03004)
No static path found for requested path. - OnlyResponseCanBeReturned (E03005)
Invalid type returned by Astro page. - MissingMediaQueryDirective (E03006)
Missing value forclient:media
directive. - NoMatchingRenderer (E03007)
No matching renderer found. - NoClientEntrypoint (E03008)
No client entrypoint specified in renderer. - NoClientOnlyHint (E03009)
Missing hint onclient:only
directive. - InvalidGetStaticPathParam (E03010)
Invalid value returned by agetStaticPaths
path. - InvalidGetStaticPathsReturn (E03011)
Invalid value returned by getStaticPaths. - GetStaticPathsRemovedRSSHelper (E03012)
getStaticPaths RSS helper is not available anymore. - GetStaticPathsExpectedParams (E03013)
Missing params property ongetStaticPaths
route. - GetStaticPathsInvalidRouteParam (E03014)
Invalid value forgetStaticPaths
route parameter. - GetStaticPathsRequired (E03015)
getStaticPaths()
function required for dynamic routes. - ReservedSlotName (E03016)
Invalid slot name. - NoAdapterInstalled (E03017)
Cannot use Server-side Rendering without an adapter. - NoMatchingImport (E03018)
No import found for component. - InvalidPrerenderExport (E03019)
Invalid prerender export. - InvalidComponentArgs (E03020)
Invalid component arguments. - PageNumberParamNotFound (E03021)
Page number param not found. - ImageMissingAlt (E03022)
Missing alt property - InvalidImageService (E03023)
Error while loading image service - MissingImageDimension (E03024)
Missing image dimensions - UnsupportedImageFormat (E03025)
Unsupported image format - UnknownViteError (E04000)
Unknown Vite Error. - FailedToLoadModuleSSR (E04001)
Could not import file. - InvalidGlob (E04002)
Invalid glob pattern.
CSS Errors
Section titled CSS Errors- UnknownCSSError (E05000)
Unknown CSS Error. - CSSSyntaxError (E05001)
CSS Syntax Error.
Markdown Errors
Section titled Markdown Errors- UnknownMarkdownError (E06000)
Unknown Markdown Error. - MarkdownFrontmatterParseError (E06001)
Failed to parse Markdown frontmatter. - InvalidFrontmatterInjectionError (E06003)
Invalid frontmatter injection. - MdxIntegrationMissingError (E06004)
MDX integration missing. - UnknownConfigError (E07000)
Unknown configuration error. - ConfigNotFound (E07001)
Specified configuration file not found. - ConfigLegacyKey (E07002)
Legacy configuration detected.
CLI Errors
Section titled CLI Errors- UnknownCLIError (E08000)
Unknown CLI Error. - GenerateContentTypesError (E08001)
Failed to generate content types.
Content Collection Errors
Section titled Content Collection Errors- UnknownContentCollectionError (E09000)
Unknown Content Collection Error. - InvalidContentEntryFrontmatterError (E09001)
Content entry frontmatter does not match schema. - InvalidContentEntrySlugError (E09002)
Invalid content entry slug. - ContentSchemaContainsSlugError (E09003)
Content Schema should not containslug
.