diff --git a/docs/core-concepts/pages/editor-blocks.mdx b/docs/core-concepts/pages/editor-blocks.mdx
index f5e6674..3a23daf 100644
--- a/docs/core-concepts/pages/editor-blocks.mdx
+++ b/docs/core-concepts/pages/editor-blocks.mdx
@@ -169,7 +169,30 @@ Both modes feature a consistent toolbar with **Save** and **Exit** buttons, maki
Creates visually distinct sections with customizable icons and colors for highlighting warnings, tips , and calls-to-action.
- ## Work item embed
+## AI block
+
+
+
+Generate or transform content directly within your pages using AI. The AI Block lets you draft new content, summarize existing text, or run custom prompts without leaving the editor.
+
+
+
+Type `/ai` to insert an AI Block. The block appears with a prompt input area and a dropdown to select the action type.
+
+### Action types
+
+**Summarize page**
+Generates a concise summary of your page content. Useful for creating executive summaries, TL;DRs, or quick overviews of longer documents.
+
+**Custom prompt**
+Write your own instructions to generate or transform content. Use this for drafting sections, rewriting text, structuring notes, expanding ideas, or any other AI-assisted writing task.
+
+
+ ## Work item