diff --git a/packages/astro/src/@types/astro.ts b/packages/astro/src/@types/astro.ts
index 8dabfa43f..9d1390ae1 100644
--- a/packages/astro/src/@types/astro.ts
+++ b/packages/astro/src/@types/astro.ts
@@ -907,8 +907,23 @@ export interface AstroUserConfig {
 	 */
 	experimental?: {
 		/**
-		 * @hidden
+		 * @docs
+		 * @name experimental.errorOverlay
+		 * @type {boolean}
+		 * @default `false`
+		 * @version 1.7.0
+		 * @description
 		 * Turn on experimental support for the new error overlay component.
+		 *
+		 * To enable this feature, set `experimental.errorOverlay` to `true` in your Astro config:
+		 *
+		 * ```js
+		 * {
+		 * 	experimental: {
+		 * 		errorOverlay: true,
+		 * 	},
+		 * }
+		 * ```
 		 */
 		errorOverlay?: boolean;
 		/**