From a9d8a59aafcb351563771c05ac61611946821317 Mon Sep 17 00:00:00 2001
From: danciaclara <claradancia20@gmail.com>
Date: Thu, 26 Feb 2026 21:37:37 +0530
Subject: [PATCH] AI block

---
 docs/core-concepts/pages/editor-blocks.mdx | 25 +++++++++++++++++++++-
 1 file changed, 24 insertions(+), 1 deletion(-)

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.
 
 <div className="tag-wrapper">
-  ## Work item embed
+## AI block
+<Tags 
+  tags={[ 
+    { name: "Pro", link:"https://plane.so/pricing", additionalClass: "pro" }
+  ]} 
+ />
+</div>
+
+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.
+
+![AI Block](https://media.docs.plane.so/pages/ai-block.webp#hero)
+
+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.
+
+<div className="tag-wrapper">
+  ## Work item
   <Tags tags={[{ name: "Pro", link: "https://plane.so/pricing", additionalClass: "pro" }]} />
 </div>