diff --git a/docs/core-concepts/issues/plane-query-language.md b/docs/core-concepts/issues/plane-query-language.md
index defc6b3..afe2236 100644
--- a/docs/core-concepts/issues/plane-query-language.md
+++ b/docs/core-concepts/issues/plane-query-language.md
@@ -7,7 +7,7 @@ description: Filter work items using text-based queries with Plane Query Languag
Plane Query Language (PQL) lets you filter work items using text-based queries. Write structured expressions to quickly find exactly what you need.
-
+
## Use the PQL editor
@@ -22,8 +22,6 @@ When you start typing in the PQL field:
3. Then you choose or type **values**
4. Continue building your query using **AND** or **OR**
-
-
This guided experience lets you construct queries without memorizing syntax.
## Query structure
diff --git a/docs/core-concepts/pages/editor-blocks.md b/docs/core-concepts/pages/editor-blocks.md
index f441037..a7aa839 100644
--- a/docs/core-concepts/pages/editor-blocks.md
+++ b/docs/core-concepts/pages/editor-blocks.md
@@ -162,7 +162,23 @@ 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
References work items directly in the editor to track details and progress.