{"record":{"id":"d8ea745c7dee1198","repo":"withastro/astro","slug":"the-adapter-adaptername-has-deprecated-its-supp","errorCode":null,"errorMessage":"The adapter ${adapterName} has deprecated its support for \"${featureName}\", and future compatibility is not guaranteed. The adapter may completely remove support for this feature without warning.","messagePattern":"The adapter (.+?) has deprecated its support for \"(.+?)\", and future compatibility is not guaranteed\\. The adapter may completely remove support for this feature without warning\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"packages/astro/src/integrations/features-validation.ts","lineNumber":153,"sourceCode":"\t}\n\n\treturn false;\n}\n\nfunction logFeatureSupport(\n\tadapterName: string,\n\tlogger: AstroLogger,\n\tfeatureName: string,\n\tsupportKind: AdapterSupport,\n\tadapterMessage?: string,\n\tsuppress?: 'all' | 'default',\n) {\n\tif (!suppress) {\n\t\tswitch (supportKind) {\n\t\t\tcase AdapterFeatureStability.STABLE:\n\t\t\t\tbreak;\n\t\t\tcase AdapterFeatureStability.DEPRECATED:\n\t\t\t\tlogger.warn(\n\t\t\t\t\t'config',\n\t\t\t\t\t`The adapter ${adapterName} has deprecated its support for \"${featureName}\", and future compatibility is not guaranteed. The adapter may completely remove support for this feature without warning.`,\n\t\t\t\t);\n\t\t\t\tbreak;\n\t\t\tcase AdapterFeatureStability.EXPERIMENTAL:\n\t\t\t\tlogger.warn(\n\t\t\t\t\t'config',\n\t\t\t\t\t`The adapter ${adapterName} provides experimental support for \"${featureName}\". You may experience issues or breaking changes until this feature is fully supported by the adapter.`,\n\t\t\t\t);\n\t\t\t\tbreak;\n\t\t\tcase AdapterFeatureStability.LIMITED:\n\t\t\t\tlogger.warn(\n\t\t\t\t\t'config',\n\t\t\t\t\t`The adapter ${adapterName} has limited support for \"${featureName}\". Certain features may not work as expected.`,\n\t\t\t\t);\n\t\t\t\tbreak;\n\t\t\tcase AdapterFeatureStability.UNSUPPORTED:\n\t\t\t\tlogger.error(","sourceCodeStart":135,"sourceCodeEnd":171,"githubUrl":"https://github.com/withastro/astro/blob/52e6c34790cc8ac4e69e6135ace06049867e5c4a/packages/astro/src/integrations/features-validation.ts#L135-L171","documentation":"At config setup Astro validates the adapter's per-feature support declarations (adapter.features). When a feature's support kind is DEPRECATED and suppression is not requested, Astro warns (domain 'config') that the adapter has deprecated that feature and may remove it without warning — the build still works today but is on borrowed time.","triggerScenarios":"Your adapter's feature map declares support: 'deprecated' for a feature the project uses (e.g. sharpImageService, envGetSecret) and neither the adapter nor your setup passes a suppress value for it.","commonSituations":"Adapter releases progressively withdrawing niche features; pairing an older adapter with a newer Astro where a feature moved to deprecated; warning appearing right after upgrading the adapter package.","solutions":["Check the adapter's changelog for the recommended migration off that feature","Migrate away from the deprecated feature, or consciously pin the adapter version while you plan the move","Adapter authors can suppress the warning for intentional use; end users can filter it from logs if the usage is deliberate"],"exampleFix":null,"handlingStrategy":"validation","validationCode":"const features = astroConfig.adapter?.features ?? {};\nfor (const [name, f] of Object.entries(features)) {\n  if (f && typeof f === 'object' && f.support === 'deprecated') {\n    console.warn('adapter deprecated feature in use: ' + name);\n  }\n}","typeGuard":"function isDeprecatedSupport(f: unknown): boolean {\n  return typeof f === 'object' && f !== null && (f as { support?: string }).support === 'deprecated';\n}","tryCatchPattern":null,"preventionTips":["Track adapter changelogs alongside Astro releases","Avoid building core flows on adapter features marked deprecated","Re-test image/secret/env flows after every adapter upgrade"],"tags":["adapter","deprecation","features","config"],"backgroundTag":"deprecated-adapter-feature","analyzedSha":"52e6c34790cc8ac4e69e6135ace06049867e5c4a","analyzedAt":"2026-08-18T18:48:03.901Z","contentChangedAt":"2026-08-18T18:48:03.901Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}