diff --git a/packages/astro/src/@types/astro.ts b/packages/astro/src/@types/astro.ts
index e139faa10..f634bf694 100644
--- a/packages/astro/src/@types/astro.ts
+++ b/packages/astro/src/@types/astro.ts
@@ -52,6 +52,9 @@ export interface AstroGlobal extends AstroGlobalPartial {
 
 export interface AstroGlobalPartial {
 	fetchContent<T = any>(globStr: string): Promise<FetchContentResult<T>[]>;
+	/**
+	 * @deprecated since version 0.24. See the {@link https://astro.build/deprecated/resolve upgrade guide} for more details.
+	 */
 	resolve: (path: string) => string;
 	site: URL;
 }