{"record":{"id":"03299bead75b8b0c","repo":"withastro/astro","slug":"the-adapter-adaptername-provides-experimental-s","errorCode":null,"errorMessage":"The adapter ${adapterName} provides experimental support for \"${featureName}\". You may experience issues or breaking changes until this feature is fully supported by the adapter.","messagePattern":"The adapter (.+?) provides experimental support for \"(.+?)\"\\. You may experience issues or breaking changes until this feature is fully supported by the adapter\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"packages/astro/src/integrations/features-validation.ts","lineNumber":159,"sourceCode":"\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(\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}","sourceCodeStart":141,"sourceCodeEnd":177,"githubUrl":"https://github.com/withastro/astro/blob/52e6c34790cc8ac4e69e6135ace06049867e5c4a/packages/astro/src/integrations/features-validation.ts#L141-L177","documentation":"Same adapter feature-validation path as the deprecated case, but for support kind EXPERIMENTAL: Astro warns (domain 'config') that the adapter provides experimental support for the feature, so you may hit issues or breaking changes until support is fully stabilized.","triggerScenarios":"The adapter declares support: 'experimental' for a feature in use (or checked via ensureAdapterSupport) and the warning is not suppressed.","commonSituations":"Enabling bleeding-edge adapter capabilities (e.g. new image services or secret managers) ahead of stabilization; warnings after an adapter ships experimental support for a previously-unsupported feature.","solutions":["Pin both astro and the adapter to known-compatible versions and retest on every upgrade","Follow the adapter's issue tracker for stabilization progress on that feature","If the feature is optional for you, disable it until the adapter marks it stable"],"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 === 'experimental') {\n    console.warn('adapter experimental feature in use: ' + name);\n  }\n}","typeGuard":"function isExperimentalSupport(f: unknown): boolean {\n  return typeof f === 'object' && f !== null && (f as { support?: string }).support === 'experimental';\n}","tryCatchPattern":null,"preventionTips":["Pin astro and adapter versions together when relying on experimental features","Add smoke tests for each experimental feature you use","Watch the adapter repo for stabilization announcements"],"tags":["adapter","experimental","features","config"],"backgroundTag":"experimental-adapter-feature","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"}