Astro Actions in Astro
From the Astro cheat sheet · Modern Astro (Server Islands, Actions, Sessions) · verified Jul 2026
Astro Actions
Type-safe server functions callable from the client (Astro 4.15+)
typescript
// src/actions/index.ts
import { defineAction } from 'astro:actions'
import { z } from 'astro:schema'
export const server = {
createComment: defineAction({
accept: 'form',
input: z.object({
postId: z.string(),
body: z.string().min(1).max(2000),
}),
handler: async ({ postId, body }, { cookies }) => {
const user = cookies.get('userId')?.value
if (!user) throw new Error('Not signed in')
return db.comment.create({ data: { postId, body, userId: user } })
},
}),
}
// Use from a client component
<form method="POST" action={actions.createComment}>
<input name="postId" value={post.id} hidden />
<textarea name="body"></textarea>
<button>Comment</button>
</form>💡 Astro Actions = type-safe server RPC with zod validation built in
📌 accept: "form" makes the action work as a plain progressive HTML form
⚡ ActionError codes map cleanly to HTTP statuses — use them, don't hand-roll
🎯 Pair with islands for forms that work without JS but enhance with it
actionsrpcforms