docs: added cloud notifications guide (#12756)

* docs: added cloud notifications guide * fixes
2025-06-17 17:23:27 +03:00
parent f12fb7dfad
commit 4443d74b61
5 changed files with 87 additions and 1 deletions
@@ -0,0 +1,53 @@
+import { InlineIcon } from "docs-ui"
+import { BellAlert } from "@medusajs/icons"
+
+export const metadata = {
+  title: `Notifications`,
+}
+
+# {metadata.title}
+
+In this guide, you'll learn about the notifications you receive in Cloud and how to view them.
+
+## Notifications Overview
+
+Cloud shows you notifications related to your organization, projects, environments, and deployments. These notifications keep you updated without needing to manually check for changes.
+
+### Notification Types
+
+Notifications may be related to:
+
+- **Payment updates**: Whether a Cloud payment subscription succeeded or failed.
+- **Database Dump Import / Export**: Notification when a database dump import or export is completed.
+- **Build and deployment failure**: Notification when a project's build or deployment fails.
+- **Build and deployment recovery**: Notification after a project's build that previously failed was successful.
+
+---
+
+## How to View Notifications
+
+### Notifications Sidebar
+
+The notifications sidebar shows you a history of all your organization's notifications.
+
+To open the notifications sidebar, click on the <InlineIcon Icon={BellAlert} alt="bell" /> icon at the top right of the Cloud dashboard.
+
+![Bell icon at the top right of the Cloud dashboard](https://res.cloudinary.com/dza7lstvk/image/upload/v1750161444/Cloud/CleanShot_2025-06-17_at_14.56.58_2x_yccifu.png)
+
+This will open the notifications sidebar, where you can see all notifications related to your organization.
+
+<Note title="Tip">
+
+To view the notifications for a different organization, learn how to [switch organizations](../organizations/page.mdx#switch-organization).
+
+</Note>
+
+![Notifications sidebar showing a list of notifications](https://res.cloudinary.com/dza7lstvk/image/upload/v1750161526/Cloud/CleanShot_2025-06-17_at_14.58.26_2x_dij4pg.png)
+
+Actionable notifications will have a link that you can click to go to the relevant page. For example, if a database dump export was completed, you can click the link to download the dump.
+
+### Toast Notifications
+
+Cloud also shows you toast notifications at the top right of the dashboard when you receive a new notification. These notifications appear momentarily and then disappear. They're helpful to quickly inform you about important updates.
+
+![Toast notification showing a new notification](https://res.cloudinary.com/dza7lstvk/image/upload/v1750161675/Cloud/CleanShot_2025-06-17_at_14.56.06_2x_fsu5ny.png)