{"record":{"id":"979487e56586c68a","repo":"withastro/astro","slug":"the-adapter-adapter-name-uses-entrypointresolu","errorCode":null,"errorMessage":"The adapter ${adapter.name} uses `entrypointResolution: \"explicit\"` by default, which is deprecated and will be removed in a future major version.","messagePattern":"The adapter (.+?) uses `entrypointResolution: \"explicit\"` by default, which is deprecated and will be removed in a future major version\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"packages/astro/src/core/dev/adapter-validation.ts","lineNumber":52,"sourceCode":"\t\t// If the adapter is not compatible with the build output, throw an error\n\t\tif (command === 'build') {\n\t\t\tconst adapterRecommendation = getAdapterStaticRecommendation(adapter.name);\n\n\t\t\tthrow new AstroError({\n\t\t\t\t...AstroErrorData.AdapterSupportOutputMismatch,\n\t\t\t\tmessage: AstroErrorData.AdapterSupportOutputMismatch.message(adapter.name),\n\t\t\t\thint: adapterRecommendation ? adapterRecommendation : undefined,\n\t\t\t});\n\t\t} else if (command === 'dev') {\n\t\t\tlogger.warn(\n\t\t\t\tnull,\n\t\t\t\t`The adapter ${adapter.name} does not support emitting a server output, but the project contain server-rendered pages. Your project will not build correctly.`,\n\t\t\t);\n\t\t}\n\t}\n\n\tif (adapter.entrypointResolution === undefined) {\n\t\tlogger.warn(\n\t\t\tnull,\n\t\t\t`The adapter ${adapter.name} uses \\`entrypointResolution: \"explicit\"\\` by default, which is deprecated and will be removed in a future major version.`,\n\t\t);\n\t\tlogger.warn(\n\t\t\tnull,\n\t\t\t'Update your adapter to use \\`entrypointResolution: \"auto\"\\` or contact the maintainers to update.',\n\t\t);\n\t}\n}\n","sourceCodeStart":34,"sourceCodeEnd":62,"githubUrl":"https://github.com/withastro/astro/blob/52e6c34790cc8ac4e69e6135ace06049867e5c4a/packages/astro/src/core/dev/adapter-validation.ts#L34-L62","documentation":"Adapters that do not set entrypointResolution implicitly use the legacy 'explicit' mode where the adapter supplies entry file paths. That implicit default is deprecated — a future major will default to 'auto' (Astro resolves entrypoints). The warning targets adapter authors and prints whenever the adapter object omits the field.","triggerScenarios":"config.adapter is registered with entrypointResolution === undefined — i.e. any adapter (typically third-party/community ones) that has not been updated to declare the field.","commonSituations":"Using a community adapter or a fork of an older official adapter after Astro introduced entrypointResolution; internal/company adapters not yet migrated.","solutions":["Adapter authors: add entrypointResolution: 'auto' to the returned AstroAdapter object","Users: upgrade to a newer release of the adapter that sets the field","If no updated release exists, open or +1 an issue with the adapter repository"],"exampleFix":"// before — adapter author's code\nexport default function myAdapter(): AstroAdapter {\n  return {\n    name: '@you/astro-adapter',\n    serverEntrypoint: new URL('./entrypoint.js', import.meta.url),\n    // entrypointResolution missing -> legacy 'explicit' default\n  };\n}\n\n// after\nexport default function myAdapter(): AstroAdapter {\n  return {\n    name: '@you/astro-adapter',\n    entrypointResolution: 'auto',\n    serverEntrypoint: new URL('./entrypoint.js', import.meta.url),\n  };\n}","handlingStrategy":"validation","validationCode":"// for adapter authors / integration tests\nimport { myAdapter } from '@you/astro-adapter';\nconst adapter = myAdapter();\nif (adapter.entrypointResolution === undefined) {\n  throw new Error('adapter must set entrypointResolution: \"auto\"');\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Adapter authors: declare entrypointResolution explicitly ('auto' unless you need explicit mode)","Users: pin adapter versions you have verified against your Astro major","Track Astro adapter-API deprecations in the changelog when maintaining a custom adapter"],"tags":["adapter","deprecation","entrypoint"],"backgroundTag":"deprecated-adapter-api","analyzedSha":"52e6c34790cc8ac4e69e6135ace06049867e5c4a","analyzedAt":"2026-08-18T18:48:03.901Z","contentChangedAt":"2026-08-18T18:48:03.901Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}