From 4dc3662ddea9fb1ce003b681de6c2197353600c5 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Mon, 13 Jul 2026 16:11:51 +0000
Subject: [PATCH 1/2] docs: explain notifications panel tab contents (forYou,
 people, documents, all)

---
 .../notifications/customize-behavior.mdx            | 13 ++++++++++++-
 async-collaboration/notifications/overview.mdx      | 11 +++++++++++
 2 files changed, 23 insertions(+), 1 deletion(-)

diff --git a/async-collaboration/notifications/customize-behavior.mdx b/async-collaboration/notifications/customize-behavior.mdx
index 77714ee5b..d95647aa6 100644
--- a/async-collaboration/notifications/customize-behavior.mdx
+++ b/async-collaboration/notifications/customize-behavior.mdx
@@ -5,7 +5,18 @@ title : "Customize Behavior"
 # Configuration
 #### setTabConfig
 - Using this config, you can customize the name of the tabs or disable them altogether.
-- By default, all the three tabs are enabled.
+- By default, the `forYou`, `documents`, and `all` tabs are enabled.
+
+The Notifications Panel supports up to four tabs. Each tab shows a different slice of the same notification data:
+
+| Tab         | What it shows                                                                                                                                                                          |
+| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `forYou`    | Notifications directed at the current user — mentions, replies to their comments, assignments, and any notification where they are an explicit recipient. Latest 50 items by default. |
+| `people`    | Notifications grouped by the user who triggered them. Useful for scanning activity by teammate.                                                                                        |
+| `documents` | Notifications grouped by document. Shows up to 15 notifications for each of the 15 most recently active documents the user can access.                                                 |
+| `all`       | Every notification across all documents the user has access to, ungrouped.                                                                                                             |
+
+The underlying notification data is the same across tabs — only the filter and grouping differ. Set `enable: false` on any tab in `tabConfig` to hide it, or change `name` to override the visible label.
 
 <Tabs>
 <Tab title="React / Next.js with Hooks">
diff --git a/async-collaboration/notifications/overview.mdx b/async-collaboration/notifications/overview.mdx
index e1e140b55..11c187fc6 100644
--- a/async-collaboration/notifications/overview.mdx
+++ b/async-collaboration/notifications/overview.mdx
@@ -9,6 +9,17 @@ You can also add custom notifications from your app into Velt's notifications fe
 
 In-app notifications are only generated and fetched for documents the user has access to.
 
+## Tabs
+
+The Notifications Panel organizes the same notification data into up to four tabs:
+
+- **For You**: Notifications directed at the current user — mentions, replies to their comments, assignments, and any notification where they are an explicit recipient.
+- **People**: Notifications grouped by the user who triggered them.
+- **Documents**: Notifications grouped by document, across the documents the current user can access.
+- **All**: Every notification across all accessible documents, ungrouped.
+
+You can rename or hide any tab with [`setTabConfig`](/async-collaboration/notifications/customize-behavior#settabconfig).
+
 ## Default Configuration
 
 **Max count:**

From 10ac83e201881bdac01b5588508b82361d0cc06b Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Mon, 13 Jul 2026 16:13:35 +0000
Subject: [PATCH 2/2] docs: add SEO descriptions and improve title on
 notifications pages

---
 async-collaboration/notifications/customize-behavior.mdx | 3 ++-
 async-collaboration/notifications/overview.mdx           | 1 +
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/async-collaboration/notifications/customize-behavior.mdx b/async-collaboration/notifications/customize-behavior.mdx
index d95647aa6..f114a8cfe 100644
--- a/async-collaboration/notifications/customize-behavior.mdx
+++ b/async-collaboration/notifications/customize-behavior.mdx
@@ -1,5 +1,6 @@
 ---
-title : "Customize Behavior"
+title: "Customize notifications behavior"
+description: "Configure notification tabs, unread counts, read-state visibility, delay and batching, and cross-organization For You feeds for the Notifications Panel."
 ---
 
 # Configuration
diff --git a/async-collaboration/notifications/overview.mdx b/async-collaboration/notifications/overview.mdx
index 11c187fc6..18e040c97 100644
--- a/async-collaboration/notifications/overview.mdx
+++ b/async-collaboration/notifications/overview.mdx
@@ -1,6 +1,7 @@
 ---
 title: "In-app Notifications"
 sidebarTitle: "Overview"
+description: "Show in-app notifications for Velt comments, mentions, replies, and custom events across the For You, People, Documents, and All tabs."
 ---
 
 By default, the in-app notifications component is connected to Velt's Comments feature. All relevant comment notifications automatically show up here.