Update your adapter to use `entrypointResolution: "auto"` or

Error message

Update your adapter to use `entrypointResolution: "auto"` or contact the maintainers to update.

What it means

Companion line to the entrypointResolution deprecation warning: after stating the adapter uses the deprecated 'explicit' default, Astro prints the remediation — update the adapter to entrypointResolution: 'auto' or contact the adapter maintainers. It always appears together with the first warning, once per validation.

Source

Thrown at packages/astro/src/core/dev/adapter-validation.ts:56

			throw new AstroError({
				...AstroErrorData.AdapterSupportOutputMismatch,
				message: AstroErrorData.AdapterSupportOutputMismatch.message(adapter.name),
				hint: adapterRecommendation ? adapterRecommendation : undefined,
			});
		} else if (command === 'dev') {
			logger.warn(
				null,
				`The adapter ${adapter.name} does not support emitting a server output, but the project contain server-rendered pages. Your project will not build correctly.`,
			);
		}
	}

	if (adapter.entrypointResolution === undefined) {
		logger.warn(
			null,
			`The adapter ${adapter.name} uses \`entrypointResolution: "explicit"\` by default, which is deprecated and will be removed in a future major version.`,
		);
		logger.warn(
			null,
			'Update your adapter to use \`entrypointResolution: "auto"\` or contact the maintainers to update.',
		);
	}
}

View on GitHub (pinned to 52e6c34790)

Solutions

Adapter authors: set entrypointResolution: 'auto' in the adapter object
Users: update the adapter package to a version that declares entrypointResolution
If unmaintained, fork it or file an issue referencing the deprecation

Example fix

// before — adapter object without the field
const adapter = { name: '@you/astro-adapter', /* ... */ };

// after
const adapter = {
  name: '@you/astro-adapter',
  entrypointResolution: 'auto',
  /* ... */
};

Defensive patterns

Strategy: validation

Validate before calling

// same guard as the paired deprecation
const adapter = myAdapter();
if (adapter.entrypointResolution === undefined) {
  throw new Error('Update the adapter to entrypointResolution: "auto"');
}

Prevention

Fix the underlying missing field rather than silencing the paired warnings
Users: update or patch third-party adapters instead of forking around the check
Keep adapter integration tests asserting the adapter object's shape

When it happens

Trigger: Identical to the paired warning: an adapter registered with entrypointResolution === undefined triggers both logger.warn calls in sequence.

Common situations: Same contexts as the deprecation itself: community adapters, internal forks, or adapters pinned to old versions after Astro introduced the field.

Related errors

AI-assisted analysis of withastro/astro@52e6c34790 (2026-08-18). Data as JSON: /api/errors/fa3ed70e2d6ca411. Report an issue: GitHub.