diff --git a/.changeset/shaggy-moons-peel.md b/.changeset/shaggy-moons-peel.md
index 702e16875399..db500d5e5c71 100644
--- a/.changeset/shaggy-moons-peel.md
+++ b/.changeset/shaggy-moons-peel.md
@@ -5,10 +5,11 @@
 Adds experimental support for the Actions API. Actions let you define type-safe endpoints you can query from client components with progressive enhancement built in.
 
 
-Actions help you write type-safe backend functions you can call from anywhere.
+Actions help you write type-safe backend functions you can call from anywhere. Enable server rendering [using the `output` property](https://docs.astro.build/en/basics/rendering-modes/#on-demand-rendered) and add the `actions` flag to the `experimental` object:
 	 
 ```js
 {
+  output: 'hybrid', // or 'server'
   experimental: {
     actions: true,
   },
diff --git a/packages/astro/src/@types/astro.ts b/packages/astro/src/@types/astro.ts
index c18e11999b74..9e45bfd23c36 100644
--- a/packages/astro/src/@types/astro.ts
+++ b/packages/astro/src/@types/astro.ts
@@ -1730,10 +1730,11 @@ export interface AstroUserConfig {
 		 * @version 4.7.0
 		 * @description
 		 *
-		 * Actions help you write type-safe backend functions you can call from anywhere.
+		 * Actions help you write type-safe backend functions you can call from anywhere. Enable server rendering [using the `output` property](https://docs.astro.build/en/basics/rendering-modes/#on-demand-rendered) and add the `actions` flag to the `experimental` object:
 		 *
 		 * ```js
 		 * {
+		 * 	 output: 'hybrid', // or 'server'
 		 *   experimental: {
 		 *     actions: true,
 		 *   },