diff --git a/docs/assets/web-app/top-right-menu/discover/api.png b/docs/assets/web-app/top-right-menu/discover/api.png
new file mode 100644
index 0000000000..8c5ff5acd0
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/discover/api.png differ
diff --git a/docs/assets/web-app/top-right-menu/discover/discover-menu.png b/docs/assets/web-app/top-right-menu/discover/discover-menu.png
deleted file mode 100644
index f56e9bac39..0000000000
Binary files a/docs/assets/web-app/top-right-menu/discover/discover-menu.png and /dev/null differ
diff --git a/docs/assets/web-app/top-right-menu/discover/products.png b/docs/assets/web-app/top-right-menu/discover/products.png
new file mode 100644
index 0000000000..9546faf237
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/discover/products.png differ
diff --git a/docs/assets/web-app/top-right-menu/discover/resources.png b/docs/assets/web-app/top-right-menu/discover/resources.png
new file mode 100644
index 0000000000..09deee238f
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/discover/resources.png differ
diff --git a/docs/assets/web-app/top-right-menu/discover/step-1-discover-button.png b/docs/assets/web-app/top-right-menu/discover/step-1-discover-button.png
new file mode 100644
index 0000000000..489f716825
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/discover/step-1-discover-button.png differ
diff --git a/docs/assets/web-app/top-right-menu/discover/step-2-discover-menu.png b/docs/assets/web-app/top-right-menu/discover/step-2-discover-menu.png
new file mode 100644
index 0000000000..3dad3b0b7a
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/discover/step-2-discover-menu.png differ
diff --git a/docs/assets/web-app/top-right-menu/discover/support.png b/docs/assets/web-app/top-right-menu/discover/support.png
new file mode 100644
index 0000000000..6c3a2fa913
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/discover/support.png differ
diff --git a/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/bulk-mark-as-read/step-1-select-notifications.png b/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/bulk-mark-as-read/step-1-select-notifications.png
new file mode 100644
index 0000000000..407381ae52
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/bulk-mark-as-read/step-1-select-notifications.png differ
diff --git a/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/bulk-mark-as-read/step-2-click-mark-as-read.png b/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/bulk-mark-as-read/step-2-click-mark-as-read.png
new file mode 100644
index 0000000000..21cfad9377
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/bulk-mark-as-read/step-2-click-mark-as-read.png differ
diff --git a/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/bulk-mark-as-read/step-3-bulk-result.png b/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/bulk-mark-as-read/step-3-bulk-result.png
new file mode 100644
index 0000000000..1a4ef54a1f
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/bulk-mark-as-read/step-3-bulk-result.png differ
diff --git a/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/mark-as-read/step-1-click-mark-all-as-read.png b/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/mark-as-read/step-1-click-mark-all-as-read.png
new file mode 100644
index 0000000000..5a35b2e94f
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/mark-as-read/step-1-click-mark-all-as-read.png differ
diff --git a/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/mark-as-read/step-2-empty-state.png b/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/mark-as-read/step-2-empty-state.png
new file mode 100644
index 0000000000..2824c9dcb6
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/mark-as-read/step-2-empty-state.png differ
diff --git a/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/navigate/flow-action.png b/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/navigate/flow-action.png
new file mode 100644
index 0000000000..d683d6609d
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/navigate/flow-action.png differ
diff --git a/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/navigate/item-actions.png b/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/navigate/item-actions.png
new file mode 100644
index 0000000000..ace34db8ee
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/navigate/item-actions.png differ
diff --git a/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/navigate/notification-item.png b/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/navigate/notification-item.png
new file mode 100644
index 0000000000..ceec003995
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/navigate/notification-item.png differ
diff --git a/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/navigate/step-1-notifications-button.png b/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/navigate/step-1-notifications-button.png
new file mode 100644
index 0000000000..36a0ae3ece
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/navigate/step-1-notifications-button.png differ
diff --git a/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/navigate/step-2-notifications-panel.png b/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/navigate/step-2-notifications-panel.png
new file mode 100644
index 0000000000..a4457a9f37
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/in-app-notifications/how-tos/navigate/step-2-notifications-panel.png differ
diff --git a/docs/assets/web-app/top-right-menu/in-app-notifications/notifications.png b/docs/assets/web-app/top-right-menu/in-app-notifications/notifications.png
deleted file mode 100644
index 6e91a11e6b..0000000000
Binary files a/docs/assets/web-app/top-right-menu/in-app-notifications/notifications.png and /dev/null differ
diff --git a/docs/assets/web-app/top-right-menu/product-updates/product-updates.png b/docs/assets/web-app/top-right-menu/product-updates/product-updates.png
deleted file mode 100644
index 561ebf1a20..0000000000
Binary files a/docs/assets/web-app/top-right-menu/product-updates/product-updates.png and /dev/null differ
diff --git a/docs/assets/web-app/top-right-menu/product-updates/step-1-product-updates-button.png b/docs/assets/web-app/top-right-menu/product-updates/step-1-product-updates-button.png
new file mode 100644
index 0000000000..c40f4a5bb9
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/product-updates/step-1-product-updates-button.png differ
diff --git a/docs/assets/web-app/top-right-menu/product-updates/step-2-product-updates-panel.png b/docs/assets/web-app/top-right-menu/product-updates/step-2-product-updates-panel.png
new file mode 100644
index 0000000000..acd64f61f3
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/product-updates/step-2-product-updates-panel.png differ
diff --git a/docs/assets/web-app/top-right-menu/theme/step-1-click-dark-mode.png b/docs/assets/web-app/top-right-menu/theme/step-1-click-dark-mode.png
new file mode 100644
index 0000000000..787919d51f
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/theme/step-1-click-dark-mode.png differ
diff --git a/docs/assets/web-app/top-right-menu/theme/step-2-dark-mode.png b/docs/assets/web-app/top-right-menu/theme/step-2-dark-mode.png
new file mode 100644
index 0000000000..7318389aa7
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/theme/step-2-dark-mode.png differ
diff --git a/docs/assets/web-app/top-right-menu/theme/step-3-click-light-mode.png b/docs/assets/web-app/top-right-menu/theme/step-3-click-light-mode.png
new file mode 100644
index 0000000000..a7a5ac14a3
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/theme/step-3-click-light-mode.png differ
diff --git a/docs/assets/web-app/top-right-menu/theme/step-4-light-mode.png b/docs/assets/web-app/top-right-menu/theme/step-4-light-mode.png
new file mode 100644
index 0000000000..3d9d65d75c
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/theme/step-4-light-mode.png differ
diff --git a/docs/assets/web-app/top-right-menu/theme/step-5-click-system-mode.png b/docs/assets/web-app/top-right-menu/theme/step-5-click-system-mode.png
new file mode 100644
index 0000000000..2960b3ea5d
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/theme/step-5-click-system-mode.png differ
diff --git a/docs/assets/web-app/top-right-menu/theme/step-6-system-mode.png b/docs/assets/web-app/top-right-menu/theme/step-6-system-mode.png
new file mode 100644
index 0000000000..9ea8c79868
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/theme/step-6-system-mode.png differ
diff --git a/docs/assets/web-app/top-right-menu/theme/theme-menu.png b/docs/assets/web-app/top-right-menu/theme/theme-menu.png
deleted file mode 100644
index cef0e330dc..0000000000
Binary files a/docs/assets/web-app/top-right-menu/theme/theme-menu.png and /dev/null differ
diff --git a/docs/assets/web-app/top-right-menu/user-profile/profile-menu.png b/docs/assets/web-app/top-right-menu/user-profile/profile-menu.png
deleted file mode 100644
index 60e916615a..0000000000
Binary files a/docs/assets/web-app/top-right-menu/user-profile/profile-menu.png and /dev/null differ
diff --git a/docs/assets/web-app/top-right-menu/user-profile/shared/step-1-avatar.png b/docs/assets/web-app/top-right-menu/user-profile/shared/step-1-avatar.png
new file mode 100644
index 0000000000..b6a8550fdf
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/user-profile/shared/step-1-avatar.png differ
diff --git a/docs/assets/web-app/top-right-menu/user-profile/shared/step-2-profile.png b/docs/assets/web-app/top-right-menu/user-profile/shared/step-2-profile.png
new file mode 100644
index 0000000000..d2a215e945
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/user-profile/shared/step-2-profile.png differ
diff --git a/docs/assets/web-app/top-right-menu/user-profile/team-restriction/step-3-click-team-badge.png b/docs/assets/web-app/top-right-menu/user-profile/team-restriction/step-3-click-team-badge.png
new file mode 100644
index 0000000000..95c6d7ca89
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/user-profile/team-restriction/step-3-click-team-badge.png differ
diff --git a/docs/assets/web-app/top-right-menu/user-profile/team-restriction/step-4-restriction-applied.png b/docs/assets/web-app/top-right-menu/user-profile/team-restriction/step-4-restriction-applied.png
new file mode 100644
index 0000000000..87a9050ed5
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/user-profile/team-restriction/step-4-restriction-applied.png differ
diff --git a/docs/assets/web-app/top-right-menu/user-profile/team-restriction/step-5-clear-restriction.png b/docs/assets/web-app/top-right-menu/user-profile/team-restriction/step-5-clear-restriction.png
new file mode 100644
index 0000000000..12d8c027ae
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/user-profile/team-restriction/step-5-clear-restriction.png differ
diff --git a/docs/assets/web-app/top-right-menu/user-profile/team-restriction/step-6-restriction-cleared.png b/docs/assets/web-app/top-right-menu/user-profile/team-restriction/step-6-restriction-cleared.png
new file mode 100644
index 0000000000..4d70bd2039
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/user-profile/team-restriction/step-6-restriction-cleared.png differ
diff --git a/docs/assets/web-app/top-right-menu/view-mode/step-1-click-card-view.png b/docs/assets/web-app/top-right-menu/view-mode/step-1-click-card-view.png
new file mode 100644
index 0000000000..1cebda0b4c
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/view-mode/step-1-click-card-view.png differ
diff --git a/docs/assets/web-app/top-right-menu/view-mode/step-2-card-view.png b/docs/assets/web-app/top-right-menu/view-mode/step-2-card-view.png
new file mode 100644
index 0000000000..b5cef3362d
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/view-mode/step-2-card-view.png differ
diff --git a/docs/assets/web-app/top-right-menu/view-mode/step-3-click-list-view.png b/docs/assets/web-app/top-right-menu/view-mode/step-3-click-list-view.png
new file mode 100644
index 0000000000..a46abc30f7
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/view-mode/step-3-click-list-view.png differ
diff --git a/docs/assets/web-app/top-right-menu/view-mode/step-4-list-view.png b/docs/assets/web-app/top-right-menu/view-mode/step-4-list-view.png
new file mode 100644
index 0000000000..8dcc2c6260
Binary files /dev/null and b/docs/assets/web-app/top-right-menu/view-mode/step-4-list-view.png differ
diff --git a/docs/assets/web-app/top-right-menu/view-mode/view-mode.png b/docs/assets/web-app/top-right-menu/view-mode/view-mode.png
deleted file mode 100644
index 28e317aa53..0000000000
Binary files a/docs/assets/web-app/top-right-menu/view-mode/view-mode.png and /dev/null differ
diff --git a/docs/settings/security/teams/team-permissions/overview.md b/docs/settings/security/teams/team-permissions/overview.md
index 817edde4c1..d677dec969 100644
--- a/docs/settings/security/teams/team-permissions/overview.md
+++ b/docs/settings/security/teams/team-permissions/overview.md
@@ -10,6 +10,9 @@ Team permissions control what actions users can perform on datastores and their
!!! note
Admins are **not** subject to team permissions and can access all data assets. Team permissions only apply to users with the **Manager** and **Member** roles. For platform-level permissions, see the [User Roles](../../users/roles/overview.md){:target="_blank"} documentation.
+!!! tip
+ Admins can preview the platform as a single-team Manager by enabling [Team Restriction Mode](../../../../using-the-platform/web-app/top-right-menu/user-profile/team-restriction.md){:target="_blank"}. This is helpful for demonstrating team permissions or diagnosing access issues reported by Members and Managers.
+
## Permission Hierarchy
Permissions follow a hierarchical model β higher permissions include all capabilities of lower permissions:
diff --git a/docs/using-the-platform/web-app/app-navigation.md b/docs/using-the-platform/web-app/app-navigation.md
index da17302492..75b48f6608 100644
--- a/docs/using-the-platform/web-app/app-navigation.md
+++ b/docs/using-the-platform/web-app/app-navigation.md
@@ -1,4 +1,4 @@
-# App Navigation
+# :material-menu:{ .middle style="color: var(--q-brick)" } App Navigation
The left sidebar of the app displays the primary navigation menu, which allows users to quickly access various functionalities of the Qualytics platform. The menu items include:
diff --git a/docs/using-the-platform/web-app/global-search/command-palette.md b/docs/using-the-platform/web-app/global-search/command-palette.md
index 01816124d9..c923d68c7d 100644
--- a/docs/using-the-platform/web-app/global-search/command-palette.md
+++ b/docs/using-the-platform/web-app/global-search/command-palette.md
@@ -1,4 +1,4 @@
-# Command Palette
+# :material-keyboard-outline:{ .middle style="color: var(--q-brick)" } Command Palette
The Command Palette is the keyboard-driven side of Global Search. It is the same overlay you open from the top search bar, but optimized for users who want to navigate, search, and act without touching the mouse.
diff --git a/docs/using-the-platform/web-app/global-search/getting-started.md b/docs/using-the-platform/web-app/global-search/getting-started.md
index d1fe6e166d..ff3c37e698 100644
--- a/docs/using-the-platform/web-app/global-search/getting-started.md
+++ b/docs/using-the-platform/web-app/global-search/getting-started.md
@@ -1,11 +1,11 @@
-# Global Search
+# :material-console-line:{ .middle style="color: var(--q-brick)" } Global Search
-The **Global Search** in Qualytics is a single, easy-to-use tool that helps you quickly find and manage everything in the platform. You can open it from the top search bar or by pressing **Ctrl + K** (Windows/Linux) or **β + K** (macOS). It acts as a command palette for navigation, operations, and creating new entities. To search for data assets (datastores, containers, and fields) by name, use **Asset Search** (`Ctrl/β + Shift + F`). You can also create templates, flows, tags, teams, service users, and tokens directly from the same place. With built-in shortcuts to move between sections like Explore, Library, Tags, Flows, and Settings, it saves time and makes working in large environments much faster and simpler.
+**Global Search** is a command palette in Qualytics that lets you navigate, run operations, and create items across the platform without leaving the keyboard. Open it from the search bar at the top of the dashboard.
!!! tip
Press **Ctrl + K** (Windows/Linux) or **β + K** (macOS) for quick access to Global Search from anywhere in the platform.
-
+
## What You Can Do With Global Search
@@ -13,7 +13,7 @@ Global Search doubles as a command palette and a navigation tool. Use it to:
- **Navigate** to any major area of the platform (Explore, Library, Tags, Flows, Settings) without leaving the keyboard.
- **Run operations** like sync, profile, scan, export, or materialize on a selected asset.
-- **Create new entities**: quality checks, check templates, flows, tags, teams, service users, and tokens.
+- **Create** quality checks, check templates, flows, tags, teams, service users, and tokens.
- **Open documentation**: the User Guide and API Docs from any page.
## Where to Go Next
diff --git a/docs/using-the-platform/web-app/global-search/keyboard-shortcuts.md b/docs/using-the-platform/web-app/global-search/keyboard-shortcuts.md
index 14076b5fb2..0e51c04219 100644
--- a/docs/using-the-platform/web-app/global-search/keyboard-shortcuts.md
+++ b/docs/using-the-platform/web-app/global-search/keyboard-shortcuts.md
@@ -1,165 +1,63 @@
-# Keyboard Shortcuts
+# :material-keyboard:{ .middle style="color: var(--q-brick)" } Keyboard Shortcuts
-Qualytics offers a comprehensive set of keyboard shortcuts to reduce mouse usage and accelerate everyday tasks. These shortcuts enable you to navigate the platform, run operations, manage checks, and update entities directly from the keyboard.
+Qualytics provides keyboard shortcuts for navigation, operations, check management, and entity actions across the platform. This page lists every available shortcut, grouped by category.
-## π Understanding the Search Bar
+!!! tip "About the Command Palette"
+ Many shortcuts also surface in the **Command Palette**, the overlay you open with `Ctrl + K` (Windows/Linux) or `β + K` (macOS). To learn how the palette behaves and how asset results appear, see [Command Palette](command-palette.md){:target="_blank"}.
-The search bar at the top of the Qualytics dashboard functions as a **Command Bar**, not a direct asset search field.
+## How Sequential Shortcuts Work
-The Command Bar is designed to:
+Some shortcuts use a two-key sequence written as `G then E`. Press each key in turn β not together β and complete the sequence within about two seconds. If you wait too long, the sequence resets and you can start again.
-- Navigate to product areas (Explore, Flows, Library, Settings, Tags)
-- Run operations (sync, scan, export, profile, materialize)
-- Create new entities (checks, templates, flows, tags)
-- Open documentation (User Guide, API Docs)
-- View keyboard shortcuts
+## Open the Keyboard Shortcuts List
-Pressing **Enter** in this bar executes the currently highlighted command.
+**Step 1:** Click the **Search** bar at the top of the dashboard, or press `Ctrl + K` (Windows/Linux) or `β + K` (macOS).
-!!! important
- The top search bar does not always return datastore, container, or field results directly. To search for data assets (such as fields like `DOB`, `DOD`, containers, or datastores), use **Asset Search** (`Ctrl/β + Shift + F`).
+
-Letβs get started π
-
-**Step 1:** Log in to your Qualytics account and click on the **Search** bar at the top of the dashboard.
-
-Alternatively, you can press **Ctrl + K** on Windows/Linux or **β + K** on macOS to open the Search bar directly.
-
-
-
-A popup window will appear, presenting various search options.
+A popup window appears with the available commands.
-### β οΈ How the Enter Key Works in the Command Bar
-
-When you type in the top search bar and press **Enter**, the system executes the **currently highlighted command** in the dropdown list.
-
-The Command Bar is designed to run commands. It does not automatically perform an asset search.
-
-Depending on what is selected, pressing Enter may:
-
-- Open a documentation page
-- Navigate to another section of the application
-- Run an operation
-- Open settings
-- Trigger another available command
-
-This is expected behavior.
-
-#### π Example
-
-- If you type **API** and the highlighted option is **Open API docs**, pressing **Enter** will open the API documentation page.
-
-- If you type **Flows** and **Go to Flows** is highlighted, pressing **Enter** will navigate to the Flows page.
-
-In both cases, the system is executing the selected command, not performing a data asset search.
-
-### π If You Want to Search for Assets
-
-To search for datastores, containers, or fields (for example, `DOB` or `DOD`), use one of the following methods:
-
-#### Option 1: Keyboard Shortcut
-
-- **Windows/Linux:** `Ctrl + Shift + F`
-- **macOS:** `β + Shift + F`
-
-#### Option 2: From the Command Bar
+**Step 2:** Select **Search keyboard shortcuts**.
-1. Open the Command Bar:
+
-- `Ctrl + K` (Windows/Linux) or `β + K` (macOS)
+The full list opens, organized by category.
-2. Select **Search datastores, containers, and fields**
-
-3. Enter your search term
-
-This ensures you are using **Asset Search mode** instead of executing a command.
-
-**Step 2:** Click on **Search Keyboard Shortcuts** to see all the shortcuts in one place.
-
-
-
-A window will appear, displaying a comprehensive list of all shortcuts organized by category.
-
-
-
-**Step 3:** You can now either search for a specific shortcut or scroll through the list to see all available options.
-
-
-
-Qualytics supports a wide range of keyboard shortcut categories, including but not limited to:
-
-| No. | Shortcut Category |
-|-----|--------------------|
-| 1. | [Navigation](#navigation) |
-| 2. | [Anomaly](#anomaly) |
-| 3. | [Check](#check) |
-| 4. | [Checks](#checks) |
-| 5. | [Container](#container) |
-| 6. | [Datastore](#datastore) |
-| 7. | [Enrichment](#enrichment) |
-| 8. | [Field](#field) |
-| 9. | [Flow](#flow) |
-| 10. | [Flow Execution](#flow-execution) |
-| 11. | [Interface](#interface) |
-| 12. | [Operations](#operations) |
-| 13. | [Search](#search) |
-| 14. | [Tags](#tags) |
-| 15. | [Template](#template) |
-
-### Search
-
-> The Search shortcuts below are specifically for asset search and keyboard shortcut lookup. The top search bar (`Ctrl/β + K`) is a Command Bar for navigation and actions.
-
-The Search Shortcuts allow you to quickly find datastores, containers, fields, and view the complete list of shortcuts.
-
-| Action | Windows/Linux | macOS |
-|--------|--------------|--------|
-| Search datastores, containers, and fields | Ctrl + Shift + F | β + Shift + F |
-| Search keyboard shortcuts | Ctrl + / | β + / |
+
-### Navigation
+**Step 3:** Scroll through the list or type to filter for a specific shortcut.
-The Navigation Shortcuts make it easy to move between pages, switch tabs, and access core areas of the Qualytics platform efficiently.
+
-| Action | Windows/Linux | macOS |
-|--------|--------------|--------|
-| Go back to previous page | G then B | G then B |
-| Go forward to next page | G then N | G then N |
-| Go to explore | G then E | G then E |
-| Go to flows | G then F | G then F |
-| Go to library | G then L | G then L |
-| Go to settings | G then S | G then S |
-| Go to tags | G then T | G then T |
-| Select next tab | Alt + β | β₯ + β |
-| Select previous tab | Alt + β | β₯ + β |
+## Shortcuts Reference
### Anomaly
-The Anomaly Shortcuts provide quick actions for archiving, deleting, or tagging anomalies, helping you manage data issues faster.
+Available on anomaly detail pages.
| Action | Windows/Linux | macOS |
|--------|--------------|--------|
| Archive anomaly | Ctrl + E | β + E |
| Assign tags | A then T | A then T |
-| Delete anomaly | Ctrl + Del | β + Del |
+| Delete anomaly | Ctrl + Delete | β + Backspace |
### Check
-The Check Shortcuts give you instant access to actions like editing, archiving, tagging, or favoriting checks directly from the keyboard.
+Available on check detail pages.
| Action | Windows/Linux | macOS |
|--------|--------------|--------|
| Archive check | Ctrl + E | β + E |
| Assign tags | A then T | A then T |
-| Delete check | Ctrl + Del | β + Del |
+| Delete check | Ctrl + Delete | β + Backspace |
| Edit check | E | E |
| Mark as favorite | Alt + F | β₯ + F |
### Checks
-The Checks Shortcuts are focused on creating new checks, whether from scratch or from templates, to speed up your validation process.
+Available where new checks can be created (datastore and template pages).
| Action | Windows/Linux | macOS |
|--------|--------------|--------|
@@ -169,76 +67,94 @@ The Checks Shortcuts are focused on creating new checks, whether from scratch or
### Container
-The Container Shortcuts let you manage containers efficiently by assigning tags, editing, deleting, or marking them as favorites.
+Available on container detail pages.
| Action | Windows/Linux | macOS |
|--------|--------------|--------|
| Assign tags | A then T | A then T |
-| Delete container | Ctrl + Del | β + Del |
+| Delete container | Ctrl + Delete | β + Backspace |
| Mark as favorite | Alt + F | β₯ + F |
| Open container settings | E | E |
### Datastore
-The Datastore Shortcuts simplify datastore management, allowing you to quickly assign tags, edit, delete, or favorite a datastore.
+Available on datastore detail pages.
| Action | Windows/Linux | macOS |
|--------|--------------|--------|
| Assign tags | A then T | A then T |
-| Delete datastore | Ctrl + Del | β + Del |
+| Delete datastore | Ctrl + Delete | β + Backspace |
| Edit datastore | E | E |
| Mark as favorite | Alt + F | β₯ + F |
### Enrichment
-The Enrichment Shortcuts provide fast access to edit or delete enrichment configurations without leaving the keyboard.
+Available on enrichment datastore detail pages.
| Action | Windows/Linux | macOS |
|--------|--------------|--------|
-| Delete enrichment | Ctrl + Del | β + Del |
+| Delete enrichment | Ctrl + Delete | β + Backspace |
| Edit enrichment | E | E |
### Field
-The Field Shortcuts help you manage fields by assigning tags, editing details, or deleting computed fields directly from the keyboard.
+Available on field detail pages.
| Action | Windows/Linux | macOS |
|--------|--------------|--------|
| Assign tags | A then T | A then T |
-| Delete computed field | Ctrl + Del | β + Del |
+| Delete computed field | Ctrl + Delete | β + Backspace |
| Edit field | E | E |
### Flow
-The Flow Shortcuts allow you to clone, delete, execute, or publish flows efficiently, reducing time spent in menus.
+Available on flow detail pages.
| Action | Windows/Linux | macOS |
|--------|--------------|--------|
| Clone flow | Ctrl + D | β + D |
-| Delete flow | Ctrl + Del | β + Del |
+| Delete flow | Ctrl + Delete | β + Backspace |
| Execute flow | Ctrl + Enter | β + Enter |
| Publish flow | P | P |
### Flow Execution
-The Flow Execution Shortcuts are designed for quick deletion of flow execution records to keep your workspace clean.
+Available on flow execution pages.
| Action | Windows/Linux | macOS |
|--------|--------------|--------|
-| Delete flow execution | Ctrl + Del | β + Del |
+| Delete flow execution | Ctrl + Delete | β + Backspace |
### Interface
-The Interface Shortcuts let you control the look and feel of the platform, such as collapsing the sidebar or switching themes.
+Available across the platform.
| Action | Windows/Linux | macOS |
|--------|--------------|--------|
| Collapse navigation sidebar | Ctrl + B | β + B |
| Switch theme | Ctrl + Shift + L | β + Shift + L |
+| Toggle Agent Q chat | Q | Q |
+
+### Navigation
+
+Available across the platform.
+
+| Action | Windows/Linux | macOS |
+|--------|--------------|--------|
+| Go back to previous page | G then B | G then B |
+| Go forward to next page | G then N | G then N |
+| Go to Agent Q | G then Q | G then Q |
+| Go to explore | G then E | G then E |
+| Go to flows | G then F | G then F |
+| Go to library | G then L | G then L |
+| Go to settings | G then S | G then S |
+| Go to tags | G then T | G then T |
+| Select next tab | Alt + β | β₯ + β |
+| Select previous tab | Alt + β | β₯ + β |
### Operations
-The Operations Shortcuts provide fast commands for running sync, export, materialize, profile, and scan operations on datastores.
+Available on datastore pages, with permission to run operations.
| Action | Windows/Linux | macOS |
|--------|--------------|--------|
@@ -248,9 +164,17 @@ The Operations Shortcuts provide fast commands for running sync, export, materia
| Run profile operation | R then P | R then P |
| Run scan operation | R then S | R then S |
+### Search
+
+Available across the platform.
+
+| Action | Windows/Linux | macOS |
+|--------|--------------|--------|
+| Search keyboard shortcuts | Ctrl + / | β + / |
+
### Tags
-The Tags Shortcuts let you quickly add new tags to classify and organize your data assets.
+Available on the Tags page.
| Action | Windows/Linux | macOS |
|--------|--------------|--------|
@@ -258,7 +182,7 @@ The Tags Shortcuts let you quickly add new tags to classify and organize your da
### Template
-The Template Shortcuts cover editing and archiving templates, helping you maintain reusable patterns with ease.
+Available on template detail pages.
| Action | Windows/Linux | macOS |
|--------|--------------|--------|
diff --git a/docs/using-the-platform/web-app/overview.md b/docs/using-the-platform/web-app/overview.md
index 0bce8384c7..d5677a7ba8 100644
--- a/docs/using-the-platform/web-app/overview.md
+++ b/docs/using-the-platform/web-app/overview.md
@@ -1,8 +1,6 @@
# Web Application Overview
-Upon signing in to Qualytics, users are greeted with a thoughtfully designed web application that offers intuitive navigation and quick access to essential features and datasets, ensuring an efficient and comprehensive data quality management experience.
-
-The web application is organized around three primary surfaces: the left sidebar for navigating across the platform, the top-right menu for account-wide preferences and notifications, and the top search bar that doubles as a command palette. Pick a section below to learn more.
+The web application is organized around three sections: the left sidebar for navigating across the platform, the top-right menu for account-wide preferences and notifications, and the top search bar that doubles as a command palette. Pick a section below to learn more.
@@ -10,7 +8,7 @@ The web application is organized around three primary surfaces: the left sidebar
---
- The left sidebar with Source Datastores, Enrichment Datastores, Explore, Library, Tags, Flows, Agent Q, and Global Settings.
+ The left sidebar to access Source Datastores, Enrichment Datastores, Explore, Library, Tags, Flows, Agent Q, and Global Settings.
[:octicons-arrow-right-24: App Navigation](app-navigation.md)
@@ -18,7 +16,7 @@ The web application is organized around three primary surfaces: the left sidebar
---
- Notifications, Discover resources, theme and view preferences, product updates, and your user profile. Every account-wide control lives here.
+ In-App Notifications, Discover, Theme, View Mode, Product Updates, and User Profile.
[:octicons-arrow-right-24: Top Right Side Menu](top-right-menu/getting-started.md)
@@ -26,7 +24,7 @@ The web application is organized around three primary surfaces: the left sidebar
---
- The Cmd/Ctrl + K command palette that lets you navigate, run operations, create entities, and search the platform from the keyboard.
+ The Cmd/Ctrl + K command palette to navigate, run operations, create assets, and search the platform.
[:octicons-arrow-right-24: Global Search](global-search/getting-started.md)
diff --git a/docs/using-the-platform/web-app/top-right-menu/discover.md b/docs/using-the-platform/web-app/top-right-menu/discover.md
index 62ad060668..15ca9af394 100644
--- a/docs/using-the-platform/web-app/top-right-menu/discover.md
+++ b/docs/using-the-platform/web-app/top-right-menu/discover.md
@@ -1,21 +1,56 @@
-# Discover
+# :material-text-box-outline:{ .middle style="color: var(--q-brick)" } Discover
-The **Discover** option in Qualytics features a dropdown menu that provides access to various resources and tools to help users navigate and utilize the platform effectively. The menu includes the following options:
+The **Discover** menu in Qualytics is a dropdown that gathers everything you need to learn about, extend, or get help with the platform. It groups external resources into four sections β Products, Resources, API, and Support β so you can jump from the web app to docs, tooling, or the helpdesk without losing your place.
-**Resources:**
+## Open the Discover Menu
-- **User Guide**: Opens the comprehensive user guide for Qualytics, which provides detailed instructions and information on how to use the platform effectively.
+**Step 1:** Click the **Discover :material-text-box-outline:** button in the top-right corner of the toolbar.
-- **SparkSQL**: Directs users to resources or documentation related to using SparkSQL within the Qualytics platform, aiding in advanced data querying and analysis.
+
-**API:**
+**Step 2:** The Discover dropdown opens with four sections β Products, Resources, API, and Support β each containing one or more links that open in a new tab.
-- **Docs**: Opens the API documentation, offering detailed information on how to interact programmatically with the Qualytics platform. This is essential for developers looking to integrate Qualytics with other systems or automate tasks.
+
-- **Playground**: Provides access to an interactive environment where users can test and experiment with API calls. This feature is particularly useful for developers who want to understand how the API works and try out different queries before implementing them in their applications.
+## Products
-**Support:**
+The **Products** section links to companion Qualytics products that extend the web app into other environments.
-- **Qualytics Helpdesk**: Provides users with access to a support environment where they can get assistance with any issues or questions related to the platform.
+| Ref | Product | Description |
+| :---: | :--- | :--- |
+| 1 | **Qualytics MCP** | Use Qualytics from inside your AI assistant by exposing data quality actions through the Model Context Protocol. |
+| 2 | **Qualytics CLI** | Run Qualytics from your terminal or CI pipeline to automate operations and integrate quality checks into your workflows. |
-
+
+
+## Resources
+
+The **Resources** section opens learning material that helps you get more out of Qualytics.
+
+| Ref | Resource | Description |
+| :---: | :--- | :--- |
+| 1 | **User Guide** | Opens the Qualytics User Guide with detailed instructions on how to use the platform. |
+| 2 | **SparkSQL** | Opens the SparkSQL reference, useful when writing filter clauses and SQL-based quality checks. |
+
+
+
+## API
+
+The **API** section gives you access to the Qualytics API surface for programmatic integrations.
+
+| Ref | Resource | Description |
+| :---: | :--- | :--- |
+| 1 | **Docs** | Opens the API documentation with endpoint details, request/response schemas, and authentication. |
+| 2 | **Playground** | Opens an interactive environment where you can test API calls against your workspace before wiring them into your application. |
+
+
+
+## Support
+
+The **Support** section is the entry point to get help from the Qualytics team.
+
+| Ref | Resource | Description |
+| :---: | :--- | :--- |
+| 1 | **Helpdesk** | Opens the support portal where you can browse articles, open tickets, and track existing requests. |
+
+
diff --git a/docs/using-the-platform/web-app/top-right-menu/getting-started.md b/docs/using-the-platform/web-app/top-right-menu/getting-started.md
index 5e019a4495..eda0b7baa3 100644
--- a/docs/using-the-platform/web-app/top-right-menu/getting-started.md
+++ b/docs/using-the-platform/web-app/top-right-menu/getting-started.md
@@ -1,6 +1,6 @@
-# Top Right Side Menu
+# :material-dots-grid:{ .middle style="color: var(--q-brick)" } Top Right Side Menu Getting Started
-The top-right area of the Qualytics web application gathers the platform-wide actions and shortcuts that follow you across every page: notifications, theme and view preferences, release updates, and your user profile.
+The top-right area of the Qualytics web application gathers the platform-wide actions and shortcuts that follow you across every page: In-App Notifications, Discover, Theme, View Mode, Product Updates, and User Profile.
This section walks through each item available in the top-right side menu.
@@ -10,19 +10,19 @@ This section walks through each item available in the top-right side menu.
---
- Real-time alerts for flow executions, including success, failure, and detected anomalies.
+ In-app alerts for flow executions, mentions, ownership changes, and anomaly assignments.
- [:octicons-arrow-right-24: In-App Notifications](in-app-notifications.md)
+ [:octicons-arrow-right-24: In-App Notifications](in-app-notifications/introduction.md)
-- :material-compass-outline:{ .lg .middle } **Discover**
+- :material-text-box-outline:{ .lg .middle } **Discover**
---
- Quick access to the User Guide, SparkSQL reference, API docs and playground, and the Qualytics Helpdesk.
+ Quick access to Qualytics MCP and CLI, the User Guide, SparkSQL reference, API docs and playground, and the Qualytics Helpdesk.
[:octicons-arrow-right-24: Discover](discover.md)
-- :material-palette-outline:{ .lg .middle } **Theme**
+- :material-theme-light-dark:{ .lg .middle } **Theme**
---
@@ -30,7 +30,7 @@ This section walks through each item available in the top-right side menu.
[:octicons-arrow-right-24: Theme](theme.md)
-- :material-view-grid-outline:{ .lg .middle } **View Mode**
+- :material-view-module:{ .lg .middle } **View Mode**
---
@@ -42,7 +42,7 @@ This section walks through each item available in the top-right side menu.
---
- Stay up to date with the latest features, fixes, and improvements directly in the app.
+ In-app changelog with the latest features, fixes, and improvements.
[:octicons-arrow-right-24: Product Updates](product-updates.md)
@@ -50,8 +50,8 @@ This section walks through each item available in the top-right side menu.
---
- Account information, role, teams, preview features toggle, logout, and the current platform version.
+ Identity information, role, teams, logout, and the current platform version. Includes Team Restriction Mode for scoping your view to a single team.
- [:octicons-arrow-right-24: User Profile](user-profile.md)
+ [:octicons-arrow-right-24: User Profile](user-profile/introduction.md)
diff --git a/docs/using-the-platform/web-app/top-right-menu/in-app-notifications.md b/docs/using-the-platform/web-app/top-right-menu/in-app-notifications.md
deleted file mode 100644
index a7b7a21142..0000000000
--- a/docs/using-the-platform/web-app/top-right-menu/in-app-notifications.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# In-App Notifications
-
-In Qualytics, notifications keep users updated on flow executions in real time. When a flow is triggered, users receive alerts with details like the flow name, status (success or failure), completion time, and actions performed.
-
-Clicking on a notification provides more details, including any detected anomalies. These notifications help users monitor workflows efficiently and respond quickly to important updates.
-
-
diff --git a/docs/using-the-platform/web-app/top-right-menu/in-app-notifications/api.md b/docs/using-the-platform/web-app/top-right-menu/in-app-notifications/api.md
new file mode 100644
index 0000000000..b19b7722fe
--- /dev/null
+++ b/docs/using-the-platform/web-app/top-right-menu/in-app-notifications/api.md
@@ -0,0 +1,275 @@
+# :material-api:{ .middle style="color: var(--q-brick)" } In-App Notifications API
+
+The In-App Notifications API provides programmatic access to the same notifications that appear in the bell panel. Use these endpoints to integrate alerts into your own tooling, build custom dashboards, or automate marking notifications as read from scripts.
+
+!!! tip "Complete API Reference"
+ For the full interactive API documentation with all request/response schemas, visit the [API docs](https://demo.qualytics.io/api/docs){:target="_blank"}.
+
+All endpoints use the base URL of your Qualytics deployment (e.g., `https://your-instance.qualytics.io/api`).
+
+---
+
+## Authentication
+
+All endpoints require a Qualytics Personal API Token (PAT) and a workspace role β **Member**, **Manager**, or **Admin**. Every response is scoped to the token's owner β you cannot retrieve another user's notifications.
+
+Include the token in the `Authorization` header:
+
+```
+Authorization: Bearer YOUR_QUALYTICS_API_TOKEN
+```
+
+For instructions on generating a token, see [Tokens](../../../../settings/tokens/overview-of-tokens.md){:target="_blank"}.
+
+---
+
+## List Notifications (Paginated)
+
+Returns your notifications sorted by creation date, with the most recent first. Supports filtering by flow trigger type, by tag, and including notifications you've already marked as read.
+
+**Endpoint**: `GET /api/user-notifications`
+
+**Permission**: Member or above
+
+??? example "Example request and response"
+
+ **Request**:
+
+ ```bash
+ curl -X GET "https://your-instance.qualytics.io/api/user-notifications?include_acknowledged=false&sort_created=desc" \
+ -H "Authorization: Bearer YOUR_QUALYTICS_TOKEN"
+ ```
+
+ **Response** (200 OK):
+
+ ```json
+ {
+ "items": [
+ {
+ "id": 42,
+ "created": "2026-05-13T12:00:00Z",
+ "acknowledged": false,
+ "notification": {
+ "id": 100,
+ "created": "2026-05-13T12:00:00Z",
+ "notification_type": "flow",
+ "message": "A Scan operation on Healthcare Analytics has completed.",
+ "target_uri": "/datastores/101/activity?operation_id=50001",
+ "target_url": "https://your-instance.qualytics.io/datastores/101/activity?operation_id=50001",
+ "action_execution": {
+ "id": 200,
+ "flow_execution": {
+ "id": 300,
+ "flow": { "id": 7, "name": "Healthcare Nightly Quality Gate" }
+ }
+ }
+ }
+ }
+ ],
+ "total": 1,
+ "page": 1,
+ "size": 12,
+ "pages": 1
+ }
+ ```
+
+**Query parameters**:
+
+| Parameter | Type | Required | Description |
+| :--- | :--- | :---: | :--- |
+| `include_acknowledged` | boolean | No | Defaults to `false`. Set to `true` to include notifications you've already marked as read. |
+| `trigger_type` | array | No | Filter by flow trigger type. Supported values: `Anomaly`, `PartitionScan`, `Operation`, `Manual`. Only applies to flow-based notifications. |
+| `tag` | array | No | Filter by tag name(s). |
+| `sort_created` | string | No | Sort order by creation date β `desc` (default) or `asc`. |
+
+---
+
+## List Notifications (Non-Paginated)
+
+Returns the same data as the paginated endpoint but as a flat array β useful for small result sets where pagination is unnecessary.
+
+**Endpoint**: `GET /api/user-notifications/listing`
+
+**Permission**: Member or above
+
+??? example "Example request and response"
+
+ **Request**:
+
+ ```bash
+ curl -X GET "https://your-instance.qualytics.io/api/user-notifications/listing?include_acknowledged=false" \
+ -H "Authorization: Bearer YOUR_QUALYTICS_TOKEN"
+ ```
+
+ **Response** (200 OK):
+
+ ```json
+ [
+ {
+ "id": 42,
+ "created": "2026-05-13T12:00:00Z",
+ "acknowledged": false,
+ "notification": {
+ "id": 100,
+ "created": "2026-05-13T12:00:00Z",
+ "notification_type": "flow",
+ "message": "A Scan operation on Healthcare Analytics has completed.",
+ "target_uri": "/datastores/101/activity?operation_id=50001",
+ "target_url": "https://your-instance.qualytics.io/datastores/101/activity?operation_id=50001",
+ "action_execution": {
+ "id": 200,
+ "flow_execution": {
+ "id": 300,
+ "flow": { "id": 7, "name": "Healthcare Nightly Quality Gate" }
+ }
+ }
+ }
+ }
+ ]
+ ```
+
+**Query parameters**:
+
+| Parameter | Type | Required | Description |
+| :--- | :--- | :---: | :--- |
+| `include_acknowledged` | boolean | No | Defaults to `false`. Set to `true` to include notifications you've already marked as read. |
+
+---
+
+## Get Single Notification
+
+Retrieve the details of one notification by its ID.
+
+**Endpoint**: `GET /api/user-notifications/{id}`
+
+**Permission**: Member or above
+
+??? example "Example request and response"
+
+ **Request**:
+
+ ```bash
+ curl -X GET "https://your-instance.qualytics.io/api/user-notifications/42" \
+ -H "Authorization: Bearer YOUR_QUALYTICS_TOKEN"
+ ```
+
+ **Response** (200 OK):
+
+ ```json
+ {
+ "id": 42,
+ "created": "2026-05-13T12:00:00Z",
+ "acknowledged": false,
+ "notification": {
+ "id": 100,
+ "created": "2026-05-13T12:00:00Z",
+ "notification_type": "flow",
+ "message": "A Scan operation on Healthcare Analytics has completed.",
+ "target_uri": "/datastores/101/activity?operation_id=50001",
+ "target_url": "https://your-instance.qualytics.io/datastores/101/activity?operation_id=50001",
+ "action_execution": {
+ "id": 200,
+ "flow_execution": {
+ "id": 300,
+ "flow": { "id": 7, "name": "Healthcare Nightly Quality Gate" }
+ }
+ }
+ }
+ }
+ ```
+
+**Path parameters**:
+
+| Parameter | Type | Required | Description |
+| :--- | :--- | :---: | :--- |
+| `id` | integer | Yes | The unique ID of the notification. |
+
+**Responses**:
+
+- `200 OK` β Notification returned.
+- `404 Not Found` β No notification with that ID exists for the authenticated user.
+
+---
+
+## Bulk Mark as Read
+
+Mark multiple notifications as read in a single request. Supply specific IDs to mark a subset as read, or pass an empty array `[]` to mark every unread notification as read.
+
+**Endpoint**: `PATCH /api/user-notifications/acknowledge`
+
+**Permission**: Member or above
+
+??? example "Example request and response"
+
+ **Request** β mark specific notifications as read:
+
+ ```bash
+ curl -X PATCH "https://your-instance.qualytics.io/api/user-notifications/acknowledge" \
+ -H "Authorization: Bearer YOUR_QUALYTICS_TOKEN" \
+ -H "Content-Type: application/json" \
+ -d '[{"id": 42}, {"id": 43}]'
+ ```
+
+ **Request** β mark all unread notifications as read:
+
+ ```bash
+ curl -X PATCH "https://your-instance.qualytics.io/api/user-notifications/acknowledge" \
+ -H "Authorization: Bearer YOUR_QUALYTICS_TOKEN" \
+ -H "Content-Type: application/json" \
+ -d '[]'
+ ```
+
+ **Response** (200 OK):
+
+ ```json
+ {
+ "acknowledged_count": 2,
+ "requested_count": 2
+ }
+ ```
+
+**Request body**: A JSON array of objects with the `id` field, or an empty array to mark all as read.
+
+| Field | Type | Required | Description |
+| :--- | :--- | :---: | :--- |
+| `id` | integer | Yes (per object) | The ID of a notification to mark as read. |
+
+---
+
+## Mark Single Notification as Read
+
+Mark exactly one notification as read.
+
+**Endpoint**: `PUT /api/user-notifications/acknowledge/{id}`
+
+**Permission**: Member or above
+
+??? example "Example request and response"
+
+ **Request**:
+
+ ```bash
+ curl -X PUT "https://your-instance.qualytics.io/api/user-notifications/acknowledge/42" \
+ -H "Authorization: Bearer YOUR_QUALYTICS_TOKEN"
+ ```
+
+ **Response** (200 OK):
+
+ ```json
+ {
+ "id": 42,
+ "created": "2026-05-13T12:00:00Z",
+ "acknowledged": true
+ }
+ ```
+
+**Path parameters**:
+
+| Parameter | Type | Required | Description |
+| :--- | :--- | :---: | :--- |
+| `id` | integer | Yes | The unique ID of the notification to mark as read. |
+
+**Responses**:
+
+- `200 OK` β Notification marked as read.
+- `404 Not Found` β No notification with that ID exists for the authenticated user.
diff --git a/docs/using-the-platform/web-app/top-right-menu/in-app-notifications/faq.md b/docs/using-the-platform/web-app/top-right-menu/in-app-notifications/faq.md
new file mode 100644
index 0000000000..87872c2107
--- /dev/null
+++ b/docs/using-the-platform/web-app/top-right-menu/in-app-notifications/faq.md
@@ -0,0 +1,55 @@
+# :material-help-circle-outline:{ .middle style="color: var(--q-brick)" } In-App Notifications FAQ
+
+## General
+
+#### What kinds of events appear in the notifications panel?
+
+Four categories: **Flow** executions (success or failure of a flow run), **Mentions** (someone tagged you in a comment), **Ownership** (a check you own was updated), and **Assignments** (an anomaly assigned to you was updated). Every notification is personal β you only see the events that involve your account.
+
+#### Are these the same as Slack or Email notifications from flows?
+
+No. The bell icon shows **in-app** notifications for you, the signed-in user. To send messages to Slack, Email, Microsoft Teams, or PagerDuty as part of a flow, configure a notification action inside the flow itself. See the [Flow Notifications](../../../../flows/notifications/overview.md){:target="_blank"} documentation.
+
+#### Can I disable specific notification types?
+
+Not today. All four notification types are delivered to every user β there is no per-type opt-out in the panel.
+
+---
+
+## Delivery & Timing
+
+#### How quickly do new notifications appear?
+
+The bell icon polls the server periodically while you're signed in. New notifications usually appear within a few seconds of the event firing β there's no need to reload the page.
+
+#### Do I get notifications when I'm signed out?
+
+The bell only updates while you're signed in. When you return to the platform, the panel surfaces every unread notification that arrived during your absence, sorted from newest to oldest.
+
+#### Are notifications synced across browsers and devices?
+
+Yes. Notifications are stored on the server and personalized to your account, so the same list appears on every browser and device you sign in to.
+
+---
+
+## Reading & Retention
+
+#### What's the difference between "Mark as read" and deleting?
+
+There is no delete action. Mark as read (via per-item check, bulk selection, or **Mark all as read**) removes the notification from the unread list, but the record is still stored on the server.
+
+#### Can I see notifications I've already marked as read?
+
+Not directly in the panel β by default only unread items are shown. You can retrieve notifications you've marked as read programmatically with the [API](api.md){:target="_blank"} by setting `include_acknowledged=true`.
+
+#### How long are notifications kept?
+
+Notifications are retained server-side as part of your account history. There is no automatic expiration today.
+
+---
+
+## Permissions
+
+#### Who can see notifications?
+
+Every authenticated user (Member, Manager, or Admin) has a personal notifications panel. There is no team-permission gating β notifications are scoped to the recipient, not to a datastore or team.
diff --git a/docs/using-the-platform/web-app/top-right-menu/in-app-notifications/how-tos/bulk-mark-as-read.md b/docs/using-the-platform/web-app/top-right-menu/in-app-notifications/how-tos/bulk-mark-as-read.md
new file mode 100644
index 0000000000..1e66372bf1
--- /dev/null
+++ b/docs/using-the-platform/web-app/top-right-menu/in-app-notifications/how-tos/bulk-mark-as-read.md
@@ -0,0 +1,19 @@
+# :material-checkbox-multiple-marked-outline:{ .middle style="color: var(--q-brick)" } Bulk Mark In-App Notifications as Read
+
+When the notifications panel has several entries you want to mark as read while keeping the rest, use **bulk mark as read**: select a subset of items with the checkboxes and mark them as read in one action. Items you don't select stay in the list.
+
+This is different from **Mark all as read**, which marks every visible item as read without selection β covered in the [Mark All In-App Notifications as Read](mark-as-read.md){:target="_blank"} page.
+
+## Steps
+
+**Step 1:** Open the **Notifications** panel and tick the checkbox at the left of each notification you want to mark as read. The panel header switches to selection mode and shows the count, e.g., **2 selected**.
+
+
+
+**Step 2:** Click the **Mark as read :material-check:** button in the panel header to mark every selected notification as read at once.
+
+
+
+**Step 3:** The selected notifications are removed from the unread list and the panel returns to the default view. Items you did not select remain in place.
+
+
diff --git a/docs/using-the-platform/web-app/top-right-menu/in-app-notifications/how-tos/mark-as-read.md b/docs/using-the-platform/web-app/top-right-menu/in-app-notifications/how-tos/mark-as-read.md
new file mode 100644
index 0000000000..176a017b59
--- /dev/null
+++ b/docs/using-the-platform/web-app/top-right-menu/in-app-notifications/how-tos/mark-as-read.md
@@ -0,0 +1,20 @@
+# :material-check-all:{ .middle style="color: var(--q-brick)" } Mark All In-App Notifications as Read
+
+When the Notifications panel is full of items you've already reviewed, **Mark all as read** marks every visible notification as read at once and clears the panel β no need to do it one at a time. The panel then shows the empty state, indicating you're fully caught up.
+
+## Steps
+
+**Step 1:** With at least one unread notification in the panel, click the **Mark all as read :material-check-all:** button in the panel header. The button appears only when no individual items are selected.
+
+
+
+**Step 2:** Every visible notification is marked as read at once, and the panel switches to its empty state.
+
+
+
+## When the Empty State Appears
+
+The same empty state appears any time you have no unread notifications β whether your account hasn't received any qualifying event yet, or you've marked every notification as read. In both cases, the bell icon in the toolbar loses its red dot.
+
+!!! tip "Notifications are kept, not deleted"
+ Marking a notification as read does not delete it β the record is still stored on the server. You can still find notifications you've marked as read through the [API](../api.md){:target="_blank"} by setting `include_acknowledged=true`.
diff --git a/docs/using-the-platform/web-app/top-right-menu/in-app-notifications/how-tos/navigate.md b/docs/using-the-platform/web-app/top-right-menu/in-app-notifications/how-tos/navigate.md
new file mode 100644
index 0000000000..de1b5318a1
--- /dev/null
+++ b/docs/using-the-platform/web-app/top-right-menu/in-app-notifications/how-tos/navigate.md
@@ -0,0 +1,52 @@
+# :material-compass:{ .middle style="color: var(--q-brick)" } In-App Notifications Navigation
+
+The **Notifications** panel is the side drawer that lists every personal notification delivered to your account. This page walks through how to open it, what each notification displays, and the actions available on every item.
+
+## Open the Notifications Panel
+
+**Step 1:** Click the **Notifications :material-bell-outline:** button in the top-right toolbar. A red dot appears on the icon when there are unread notifications.
+
+
+
+**Step 2:** The **Notifications** side panel opens on the right, listing your unread notifications from newest to oldest. Scroll down to load older entries automatically.
+
+
+
+## Notification Item
+
+Each entry in the panel surfaces the same set of fields, regardless of the notification type.
+
+
+
+| Field | Description |
+| :--- | :--- |
+| **Category** | Either `Flow` (for flow executions) or `Notification` (for mentions, ownership, and assignment events). |
+| **Type** | The specific event type β `Mention`, `Ownership`, `Assignment`, or the flow name for flow notifications. |
+| **Message** | A short summary of what happened, including the related entity (anomaly ID, check ID, datastore name). |
+| **Date** | The relative time since the event (e.g., "2 hours ago", "yesterday"). For the full UTC timestamp, hover the **:material-clock-outline:** icon in the per-item actions. |
+| **Checkbox** | Selects the item for [bulk mark as read](bulk-mark-as-read.md){:target="_blank"}. |
+
+## Per-Item Actions
+
+Hover any notification to reveal the action icons in the item header.
+
+
+
+| REF. | ICON | ACTION | DESCRIPTION |
+| :---: | :---: | :--- | :--- |
+| 1 | **:material-clock-outline:** | Timestamp | Displays the full UTC timestamp of when the event occurred. This icon is informational only β it is not clickable. |
+| 2 | **:material-check:** | Mark as read | Marks this single notification as read and removes it from the unread list. |
+| 3 | **:material-open-in-new:** | View linked page | Navigates to the entity the notification refers to (anomaly, check, datastore, or other linked asset). |
+
+### Flow-Specific Action
+
+Flow notifications include one additional icon that links to the flow execution itself.
+
+
+
+| REF. | ICON | ACTION | DESCRIPTION |
+| :---: | :---: | :--- | :--- |
+| 4 | **:material-sitemap-outline:** | View flow execution | Opens the flow execution detail page so you can inspect the run, its steps, and any anomalies it produced. |
+
+!!! tip "Automatic updates"
+ The bell icon refreshes its unread badge automatically while you're signed in β there's no need to reload the page to see new notifications arrive.
diff --git a/docs/using-the-platform/web-app/top-right-menu/in-app-notifications/introduction.md b/docs/using-the-platform/web-app/top-right-menu/in-app-notifications/introduction.md
new file mode 100644
index 0000000000..28c9e8d46f
--- /dev/null
+++ b/docs/using-the-platform/web-app/top-right-menu/in-app-notifications/introduction.md
@@ -0,0 +1,77 @@
+# :material-bell-outline:{ .middle style="color: var(--q-brick)" } In-App Notifications Introduction
+
+## Overview
+
+**In-App Notifications** keep you informed of activity that involves you or the data assets you care about β flow executions, anomalies you're assigned to, checks you own, and comments that mention you. The bell icon in the top-right toolbar surfaces these events without requiring you to set up email, Slack, or other external channels.
+
+This section walks through what notifications look like, how to read them, and how to manage them in bulk.
+
+## What Triggers a Notification
+
+Qualytics delivers four kinds of in-app notifications:
+
+- **Flow** β A flow execution has completed (success or failure), including details about the operation that ran and the result.
+- **Mention** β Someone tagged you in a comment on a check, anomaly, or other asset.
+- **Ownership** β A check you own was updated by another user.
+- **Assignment** β An anomaly you're assigned to was updated.
+
+Each notification is **personal to you** β only the events relevant to your account, ownerships, assignments, and mentions appear in your panel.
+
+!!! info "In-app vs. flow notifications"
+ The bell icon here surfaces activity for **you, the signed-in user**. To send notifications to external channels (Slack, Email, Microsoft Teams, PagerDuty) as part of a flow, configure a notification action inside the flow itself. See the [Flow Notifications](../../../../flows/notifications/overview.md){:target="_blank"} documentation.
+
+---
+
+## How-tos
+
+
+
+- :material-compass:{ .lg .middle } **Navigate**
+
+ ---
+
+ Open the notifications panel, understand each item's fields, and learn the per-item action icons.
+
+ [:octicons-arrow-right-24: Navigate](how-tos/navigate.md)
+
+- :material-check-all:{ .lg .middle } **Mark as Read**
+
+ ---
+
+ Mark every unread notification as read at once and clear the panel.
+
+ [:octicons-arrow-right-24: Mark as Read](how-tos/mark-as-read.md)
+
+- :material-checkbox-multiple-marked-outline:{ .lg .middle } **Bulk Mark as Read**
+
+ ---
+
+ Select multiple notifications and mark them as read together in one action.
+
+ [:octicons-arrow-right-24: Bulk Mark as Read](how-tos/bulk-mark-as-read.md)
+
+
+
+---
+
+## API & FAQ
+
+
+
+- :material-api:{ .lg .middle } **API**
+
+ ---
+
+ Programmatic access to list and acknowledge your in-app notifications via the Qualytics REST API.
+
+ [:octicons-arrow-right-24: API](api.md)
+
+- :material-help-circle-outline:{ .lg .middle } **FAQ**
+
+ ---
+
+ Common questions about notification types, delivery, retention, and permissions.
+
+ [:octicons-arrow-right-24: FAQ](faq.md)
+
+
diff --git a/docs/using-the-platform/web-app/top-right-menu/product-updates.md b/docs/using-the-platform/web-app/top-right-menu/product-updates.md
index b72d622b18..e61eb45681 100644
--- a/docs/using-the-platform/web-app/top-right-menu/product-updates.md
+++ b/docs/using-the-platform/web-app/top-right-menu/product-updates.md
@@ -1,5 +1,29 @@
-# Product Updates
+# :material-bullhorn-outline:{ .middle style="color: var(--q-brick)" } Product Updates
-In Qualytics, the Product Updates feature helps users stay up to date with the latest changes. They can see new features, bug fixes, and improvements directly in the app, with links to full release notes for more details.
+**Product Updates** is the in-app changelog that surfaces what's new in Qualytics β features, improvements, and fixes that shipped in recent releases. The button is in the top-right toolbar β clicking it opens a side panel from the right, the fastest way to learn what changed since you last logged in without leaving the platform or hunting for release notes.
-
+## What's Inside
+
+The panel displays the **last 8 releases**, sorted from newest to oldest. Each entry includes:
+
+- A **date badge** showing when the release shipped (formatted as `Month D, YYYY` β e.g., `May 7, 2026`).
+- The full **release notes**, rendered from markdown β headings, bullet lists, code snippets, screenshots, and links all appear inline.
+- A **distinct color on the date badge** of the most recent release, so it stands out at the top of the panel.
+
+When a new release becomes available, the toolbar icon changes from outline to filled and shows a notification dot until you open the panel. After you view it, the icon returns to outline and the dot clears until the next release lands.
+
+!!! note "No pagination"
+ The panel always shows up to 8 entries at once with no "see more" link. Older releases roll off the list as new ones are published.
+
+## Open the Product Updates Panel
+
+**Step 1:** Click the **Product Updates :material-bullhorn-outline:** button in the top-right toolbar. A notification dot appears on the icon when there are unread releases.
+
+
+
+**Step 2:** The **What's New** panel opens on the right, listing the most recent releases with their date badges and full release notes. Scroll through the panel to read older entries.
+
+
+
+!!! tip "Reading on the go"
+ Links inside release notes open in a new tab β you can keep the panel open and explore linked features or external posts without losing your place.
diff --git a/docs/using-the-platform/web-app/top-right-menu/theme.md b/docs/using-the-platform/web-app/top-right-menu/theme.md
index 6825c19450..b97b9c5794 100644
--- a/docs/using-the-platform/web-app/top-right-menu/theme.md
+++ b/docs/using-the-platform/web-app/top-right-menu/theme.md
@@ -1,32 +1,53 @@
-# Theme
+# :material-theme-light-dark:{ .middle style="color: var(--q-brick)" } Theme
-Qualytics offers both dark mode and light mode to enhance user experience and cater to different preferences and environments.
+Qualytics offers three appearance options β **Dark Mode**, **Light Mode**, and **System** β so the interface can match your environment and personal preference. The active theme is set from the **Theme** icon in the top-right toolbar and remembered across sessions on the same browser.
-**Light Mode:**
+## Theme Options
-- This is the default visual theme of Qualytics, featuring a light background with dark text.
+| Theme | Behavior |
+| :--- | :--- |
+| **Dark Mode** | Dark background with light text. Reduces glare and eye strain in low-light environments and can save battery on OLED screens. |
+| **Light Mode** | Light background with dark text. Best for well-lit environments and prolonged daytime use. |
+| **System** | Follows your operating system's appearance setting automatically. If your OS is configured to switch between light and dark on a schedule, Qualytics follows it without manual intervention. |
-- It provides a clean and bright interface, which is ideal for use in well-lit environments.
+## Cycle Between Themes
-- To switch from dark mode to light mode, click the **Light Mode** button.
+The three options form a cycle β each click of the **Theme** icon advances to the next mode.
-**Dark Mode:**
+
-- Dark mode features a dark background with light text, reducing eye strain and glare, especially in low-light environments.
+```mermaid
+graph LR
+ A["Dark Mode"] -->|"Click theme icon"| B["Light Mode"]
+ B -->|"Click theme icon"| C["System"]
+ C -->|"Click theme icon"| A
+```
-- It is designed to be easier on the eyes during prolonged usage and can help save battery life on devices.
+
-- To activate dark mode, click the **Dark Mode** button.
+=== "Switch to System"
-**System Appearance:**
+ **Step 1:** From Light Mode, click the **Theme** icon in the top-right toolbar. The interface follows your operating system's light/dark setting, updating automatically when the OS toggles its theme.
-- The system theme automatically adjusts based on the user's device settings.
+ 
-- When enabled, Qualytics will switch between light and dark mode based on the system preference.
+ 
-- It provides a seamless experience by adapting to the user's environment without manual adjustments.
+=== "Switch to Dark Mode"
-!!! tip
- Users can still manually select **dark** or **light** mode if they prefer a fixed theme.
+ **Step 1:** From System, click the **Theme** icon in the top-right toolbar. The interface switches to a dark background with light text.
-
+ 
+
+ 
+
+=== "Switch to Light Mode"
+
+ **Step 1:** From Dark Mode, click the **Theme** icon in the top-right toolbar. The interface switches to a light background with dark text.
+
+ 
+
+ 
+
+!!! tip "Persistence"
+ Your theme choice is stored locally in the browser. The icon and tooltip reflect the currently applied theme.
diff --git a/docs/using-the-platform/web-app/top-right-menu/user-profile.md b/docs/using-the-platform/web-app/top-right-menu/user-profile.md
deleted file mode 100644
index e34daef8d0..0000000000
--- a/docs/using-the-platform/web-app/top-right-menu/user-profile.md
+++ /dev/null
@@ -1,17 +0,0 @@
-# User Profile
-
-The user profile section in Qualytics provides essential information and settings related to the user's account. Here's an explanation of each element:
-
-- **Name**: Displays the user's email address used as the account identifier.
-
-- **Role**: Indicates the user's role within the Qualytics platform (e.g., Admin), which defines their level of access and permissions.
-
-- **Teams**: Shows the teams to which the user belongs (e.g., Public), helping organize users and manage permissions based on group membership.
-
-- **Preview Features**: A toggle switch that enables or disables preview features. When turned on, it adds an AI Readiness Benchmark for the Quality Score specifically on the Explore page.
-
-- **Logout**: A button that logs the user out of their Qualytics account, ending the current session and returning them to the login page.
-
-- **Version**: Displays the current version of the Qualytics platform being used, which is helpful for troubleshooting and ensuring compatibility with other tools and features.
-
-
diff --git a/docs/using-the-platform/web-app/top-right-menu/user-profile/introduction.md b/docs/using-the-platform/web-app/top-right-menu/user-profile/introduction.md
new file mode 100644
index 0000000000..1bb0c76479
--- /dev/null
+++ b/docs/using-the-platform/web-app/top-right-menu/user-profile/introduction.md
@@ -0,0 +1,49 @@
+# :material-account-circle-outline:{ .middle style="color: var(--q-brick)" } User Profile Introduction
+
+## Overview
+
+The **User Profile** menu is the personal control center for your Qualytics session. You open it by clicking your avatar in the top-right corner of the toolbar, and from there you can confirm who you are signed in as, see which role and teams determine what you can do, check the platform version, and sign out.
+
+This page covers what each part of the profile menu represents and how the role and team information shown there influences what you see and can do across the platform.
+
+## What's in the Profile Menu
+
+- **Identity** β your email address, used as the account identifier.
+- **Role** β your workspace-level role (Member, Manager, or Admin).
+- **Teams** β the teams you belong to. Each team badge is also the entry point to Team Restriction Mode.
+- **Version** β the Qualytics platform version currently running.
+- **Logout** β ends your session and returns you to the login page.
+
+For what each item does, follow the cards below.
+
+---
+
+## Deep Dive
+
+
+
+- :material-account-circle-outline:{ .lg .middle } **Profile**
+
+ ---
+
+ Walk through each item in the profile menu β identity, role, teams, logout, and platform version.
+
+ [:octicons-arrow-right-24: Profile](profile.md)
+
+
+
+---
+
+## How-tos
+
+
+
+- :material-account-lock:{ .lg .middle } **Team Restriction Mode**
+
+ ---
+
+ Scope your view to a single team to demonstrate role-based access control or diagnose permission issues.
+
+ [:octicons-arrow-right-24: Team Restriction Mode](team-restriction.md)
+
+
diff --git a/docs/using-the-platform/web-app/top-right-menu/user-profile/profile.md b/docs/using-the-platform/web-app/top-right-menu/user-profile/profile.md
new file mode 100644
index 0000000000..043a252cc0
--- /dev/null
+++ b/docs/using-the-platform/web-app/top-right-menu/user-profile/profile.md
@@ -0,0 +1,21 @@
+# :material-account-circle-outline:{ .middle style="color: var(--q-brick)" } Profile
+
+The user profile section in Qualytics provides essential information and settings related to your account. Open it by clicking your **avatar** in the top-right corner of the toolbar.
+
+**Step 1:** Click your avatar in the top-right corner of the toolbar.
+
+
+
+**Step 2:** The profile menu opens with the following items:
+
+
+
+- **Identity**: Shows your name if your account has one on file; otherwise shows your email, or a unique identifier as a fallback. This is how Qualytics recognizes you across sessions.
+
+- **Role**: Indicates your workspace role β **Member**, **Manager**, or **Admin** β which defines your baseline permissions.
+
+- **Teams**: Shows the teams you belong to, helping organize users and manage permissions based on group membership. Clicking a team badge applies **Team Restriction Mode** immediately and reloads the page, scoping your session to that team only. See [Team Restriction Mode](team-restriction.md){:target="_blank"} for details.
+
+- **Logout**: A button that logs you out of your Qualytics account, ending the current session and returning you to the login page.
+
+- **Version**: Displays the Qualytics platform version currently running. Useful when troubleshooting or filing a support ticket.
diff --git a/docs/using-the-platform/web-app/top-right-menu/user-profile/team-restriction.md b/docs/using-the-platform/web-app/top-right-menu/user-profile/team-restriction.md
new file mode 100644
index 0000000000..8893c18883
--- /dev/null
+++ b/docs/using-the-platform/web-app/top-right-menu/user-profile/team-restriction.md
@@ -0,0 +1,78 @@
+# :material-account-lock:{ .middle style="color: var(--q-brick)" } Team Restriction Mode
+
+Team Restriction Mode lets you scope your view to a single team, so the platform behaves as if you were a regular member of that team only. Admins who turn it on also see their role downgraded to Manager for the duration of the restriction.
+
+This is useful for three scenarios:
+
+- **Demonstrating role-based access control** β show stakeholders exactly what a team member sees, without creating a separate test account.
+- **Diagnosing permission issues** β reproduce what a teammate experiences when they report missing data or actions caused by team-level scoping.
+- **Focusing your work on one team** β when you belong to many teams, narrow your view to just one to reduce noise and concentrate on that team's datastores.
+
+## How It Works
+
+When a restriction is active, the platform applies the following rules to your session:
+
+- **Teams** β only the selected team is considered. Memberships in other teams are ignored.
+- **Permissions** β derived from your role in the selected team only, not from the combined permissions of every team you belong to.
+- **Admin role** β if you are an Admin, your effective role becomes Manager. This means you become subject to team permissions like any other Manager and lose access to admin-only actions until the restriction is cleared.
+- **Persistence** β the restriction is stored locally in your browser and stays in effect across page refreshes and navigation. It is tied to your browser, not to your account, so signing in on another device starts unrestricted.
+
+## Permissions
+
+Team Restriction Mode is available to any user who belongs to two or more teams β there is no separate permission to enable it.
+
+- **Admins** who enable it see their effective role downgraded to **Manager** for the duration of the restriction. Admin-only actions and global access are paused until the restriction is cleared.
+- The **Internal** automation role is never subject to the restriction. API traffic outside this browser session (CLI, personal access tokens, MCP) is also unaffected.
+
+!!! note "Scope of the restriction"
+ Team Restriction Mode does **not** require any team permission (Reporter, Viewer, Drafter, Author, Editor). It is a session-level control, not an action governed by the team permission matrix. See [Team Permissions](../../../../settings/security/teams/team-permissions/overview.md){:target="_blank"} for what each team permission allows.
+
+## Apply and Clear a Team Restriction
+
+You must belong to **at least two teams** to use this feature. The full lifecycle β applying a restriction and clearing it again β takes six steps.
+
+**Step 1:** Click your avatar in the top-right corner of the toolbar.
+
+
+
+**Step 2:** The profile menu opens, listing your identity, role, teams, logout, and version.
+
+
+
+**Step 3:** In the **Teams** section, click the badge of the team you want to restrict your view to.
+
+
+
+**Step 4:** Qualytics re-evaluates your permissions and refreshes the current view with the restriction applied. The toolbar shows a yellow team-restriction badge with a **Lock :material-account-lock:** icon and the team name. If you are an Admin, the profile menu now shows a faded **Admin** badge alongside a **Manager** badge, indicating that your role is temporarily Manager while the restriction is active.
+
+
+
+**Step 5:** When you're ready to return to your full session, click the **Remove team restriction :material-close-circle-outline:** button on the team badge in the toolbar.
+
+
+
+**Step 6:** Qualytics re-evaluates your permissions and refreshes the current view. Your full session is restored, including all team memberships and your original role.
+
+
+
+!!! tip "Switch to a Different Team"
+ To swap from one restricted team to another without clearing first, repeat Steps 1β3 and pick a different team badge. The restriction switches immediately to the new team without an intermediate unrestricted state.
+
+## Behavior When Access Changes
+
+When you apply, switch, or clear a restriction, Qualytics re-evaluates which data you can see and refreshes the current view. If you happen to be on a page whose datastore is not accessible under the new scope, Qualytics redirects you to a page you can access and shows a notification explaining that you don't have permission for the previous page.
+
+This behavior is intentional and prevents the UI from showing partial or stale data after the scope changes.
+
+## Limitations
+
+- The restriction is browser-local. It does not follow you to another device or another browser profile.
+- Clearing your browser storage clears the restriction.
+- The restriction only affects this browser session. Programmatic API calls outside the browser β such as the Qualytics CLI, personal access tokens used in scripts, or MCP tools β do not send the restriction header and are unaffected. Your underlying role, team memberships, and audit records are also not changed.
+- Team Restriction Mode scopes by team membership only. It does not simulate a different team-level permission (Reporter, Viewer, Drafter, Author, Editor) within the same team β your team permissions stay as they are.
+- If you are removed from the restricted team in another session, requests will fail with a "not a member" error until you clear the restriction (remove it via the toolbar button, or clear browser storage).
+
+## Related
+
+- [Team Permissions](../../../../settings/security/teams/team-permissions/overview.md){:target="_blank"} β the permission matrix that defines what each team role can do.
+- [Profile](profile.md){:target="_blank"} β overview of the profile menu where the **Teams** section lives.
diff --git a/docs/using-the-platform/web-app/top-right-menu/view-mode.md b/docs/using-the-platform/web-app/top-right-menu/view-mode.md
index 8850de7b66..ffc9462909 100644
--- a/docs/using-the-platform/web-app/top-right-menu/view-mode.md
+++ b/docs/using-the-platform/web-app/top-right-menu/view-mode.md
@@ -1,9 +1,48 @@
-# View Mode
+# :material-view-module:{ .middle style="color: var(--q-brick)" } View Mode
-In Qualytics, users have the option to switch between two display modes: List View and Card View. These modes are available on the Source Datastore page, Enrichment Datastore page, and Library page, allowing users to choose their preferred method of displaying information.
+The **View Mode** toggle in Qualytics lets you switch between two layouts on listing pages β a compact **List View** that fits more rows on screen, or a **Card View** that surfaces more information per item. The toggle lives in the top-right toolbar and your preference is remembered across sessions on the same browser.
-- **List View**: List View arranges items in a linear, vertical list format. This mode focuses on providing detailed information in a compact and organized manner. To activate List View, click the "List View" button (represented by an icon with three horizontal lines) located at the top of the page.
+## Where View Mode Applies
-- **Card View**: Card View displays items as individual cards arranged in a grid. Each card typically includes a summary of the most important information about the item. To switch to Card View, click the "Card View" button (represented by an icon with a grid of squares) located at the top of the page.
+The toggle is available on every Qualytics page that renders a listing of items. Switching it on any of these pages updates your global preference:
-
+- **Source Datastores** listing page
+- **Enrichment Datastores** listing page
+- **Containers** inside a source datastore (Tables / Views / Files)
+- **Library** β Check Templates
+- **Explore** β Containers listing
+- **Anomalies** β Datastore, Container, Field, and Explore anomaly listings
+- **Checks** β Datastore, Container, Field, and Explore check listings
+
+## Toggle Between Views
+
+The two views form a simple cycle β clicking the active button switches to the other layout.
+
+
+
+```mermaid
+graph LR
+ A["List View
Compact rows"] -->|"Click Card View"| B["Card View
Rich cards"]
+ B -->|"Click List View"| A
+```
+
+
+
+=== "Switch to Card View"
+
+ **Step 1:** While in List View, click the **Card View :material-view-module:** button in the top-right toolbar. The page switches to Card View, displaying items as cards arranged in a grid with a summary of the most important information per item.
+
+ 
+
+ 
+
+=== "Switch to List View"
+
+ **Step 1:** While in Card View, click the **List View :material-format-list-bulleted:** button in the top-right toolbar. The page switches to List View, displaying items as a dense, vertical list optimized for scanning many rows at once.
+
+ 
+
+ 
+
+!!! tip "Persistence"
+ Your View Mode choice is stored locally in the browser and applies platform-wide. Switching it on any listing page also updates every other listing page that supports the toggle.
diff --git a/mkdocs.yml b/mkdocs.yml
index f713a9a188..3b7d68d2b7 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -36,12 +36,22 @@ nav:
- App Navigation: using-the-platform/web-app/app-navigation.md
- Top Right Side Menu:
- Getting Started: using-the-platform/web-app/top-right-menu/getting-started.md
- - In-App Notifications: using-the-platform/web-app/top-right-menu/in-app-notifications.md
+ - In-App Notifications:
+ - Introduction: using-the-platform/web-app/top-right-menu/in-app-notifications/introduction.md
+ - How-tos:
+ - Navigate: using-the-platform/web-app/top-right-menu/in-app-notifications/how-tos/navigate.md
+ - Mark as Read: using-the-platform/web-app/top-right-menu/in-app-notifications/how-tos/mark-as-read.md
+ - Bulk Mark as Read: using-the-platform/web-app/top-right-menu/in-app-notifications/how-tos/bulk-mark-as-read.md
+ - FAQ: using-the-platform/web-app/top-right-menu/in-app-notifications/faq.md
+ - API: using-the-platform/web-app/top-right-menu/in-app-notifications/api.md
- Discover: using-the-platform/web-app/top-right-menu/discover.md
- Theme: using-the-platform/web-app/top-right-menu/theme.md
- View Mode: using-the-platform/web-app/top-right-menu/view-mode.md
- Product Updates: using-the-platform/web-app/top-right-menu/product-updates.md
- - User Profile: using-the-platform/web-app/top-right-menu/user-profile.md
+ - User Profile:
+ - Introduction: using-the-platform/web-app/top-right-menu/user-profile/introduction.md
+ - Profile: using-the-platform/web-app/top-right-menu/user-profile/profile.md
+ - Team Restriction: using-the-platform/web-app/top-right-menu/user-profile/team-restriction.md
- Global Search:
- Getting Started: using-the-platform/web-app/global-search/getting-started.md
- Command Palette: using-the-platform/web-app/global-search/command-palette.md