{"record":{"id":"aac615bbea44507e","repo":"withastro/astro","slug":"the-adapter-adaptername-has-limited-support-for","errorCode":null,"errorMessage":"The adapter ${adapterName} has limited support for \"${featureName}\". Certain features may not work as expected.","messagePattern":"The adapter (.+?) has limited support for \"(.+?)\"\\. Certain features may not work as expected\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"packages/astro/src/integrations/features-validation.ts","lineNumber":165,"sourceCode":") {\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(\n\t\t\t\t\t'config',\n\t\t\t\t\t`The adapter ${adapterName} does not currently support the feature \"${featureName}\". Your project may not build correctly.`,\n\t\t\t\t);\n\t\t\t\tbreak;\n\t\t}\n\t}\n\n\t// If the adapter specified a custom message, log it after the default message (when not suppressed)\n\tif (adapterMessage && suppress !== 'all') {\n\t\tlogger.warn('adapter', adapterMessage);\n\t}\n}","sourceCodeStart":147,"sourceCodeEnd":183,"githubUrl":"https://github.com/withastro/astro/blob/52e6c34790cc8ac4e69e6135ace06049867e5c4a/packages/astro/src/integrations/features-validation.ts#L147-L183","documentation":"Same adapter feature-validation path, but for support kind LIMITED: Astro warns (domain 'config') that the adapter has limited support for the feature and certain functionality may not work as expected — the adapter implements it only partially.","triggerScenarios":"The adapter declares support: 'limited' for a feature the project relies on and the warning is not suppressed.","commonSituations":"Platform-specific adapters implementing a subset of a feature (e.g. partial edge-image or env-secret support); behavior differences surfacing only in production on that platform.","solutions":["Read the adapter's docs for the exact limitations of that feature and test those paths explicitly","Work around the unsupported parts (e.g. preprocess images at build time, or fetch secrets elsewhere)","If the limitation blocks you, switch to an adapter with full support for that feature"],"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 === 'limited') {\n    console.warn('adapter limited feature in use: ' + name);\n  }\n}","typeGuard":"function isLimitedSupport(f: unknown): boolean {\n  return typeof f === 'object' && f !== null && (f as { support?: string }).support === 'limited';\n}","tryCatchPattern":null,"preventionTips":["Read the adapter's limitation list for each feature before depending on it","Add targeted tests for the limited code paths in production-like environments","Have a fallback adapter choice when a limitation blocks your use case"],"tags":["adapter","limited-support","features","config"],"backgroundTag":"limited-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"}