> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Notifications: system notifications and in-app notifications

> The system notifications switch, permission and three alert types, and when a banner appears; filtering, marking as read and navigation in the in-app notifications list.

AIHubMix Cloud has two independent kinds of notifications. **System notifications** are banners shown by the operating system (or browser) to alert you when you are not looking at Cloud. **In-app notifications** are the notification list in **Settings › Notifications**, which keeps a record of your notifications. Turning off system notifications does not affect the in-app record.

## Availability

| Platform | Support | Notes |
| - | - | - |
| Desktop app | Supported | Native system notifications; asks for notification permission once after you finish or skip sign-in onboarding; the unread count appears on the Dock icon |
| Web app | Supported | Uses browser notifications; does not ask for permission automatically, so you turn it on in Settings; the unread count appears before the browser tab title |
| Mobile web | Partial | In-app notifications are available; some mobile browsers do not support web notifications, in which case **System permission** shows **Not supported** |

## Where to find it

* **System notification settings**: the **System notifications** group in **Settings › General**. The gear **Notification settings** in the upper-right corner of the in-app notifications list also opens it.
* **In-app notifications list**: account menu › **Notifications** (shows the unread count when there are unread notifications, and a small dot appears on your avatar); **Settings › Personal › Notifications**; **View notifications** to the right of the **System notifications** heading; shortcut `⌥⌘U` (Windows: `Ctrl+Alt+U`).

## System notifications

### Settings

| Setting | Description |
| - | - |
| System notifications | The main switch, on by default |
| System permission | Whether the operating system (or browser) allows Cloud to send notifications: **Not requested**, **Allowed**, **Not allowed** or **Not supported**. The button is **Allow notifications** when the status is **Not requested**, and **System Settings** otherwise |
| Task completed | A session or scheduled task finished |
| Needs your attention | Approval, more information or manual takeover |
| Task issues | Execution failed, was interrupted, or a scheduled task was paused automatically |

* All three alert types are on by default. When you turn off the main switch, your choices for the three alert types are kept and restored when you turn it back on.
* **System Settings** opens the operating system's notification settings directly in the desktop app. In the web app, change it in your browser settings.
* Sound, Do Not Disturb and similar behavior for notifications are controlled by the operating system.

### First-time permission

* **Desktop app**: the first time you finish or skip sign-in onboarding, the operating system shows a permission prompt once. After that, you can click **Allow notifications** to request again, or click **System Settings** to change it.
* **Web app**: does not ask automatically. The browser shows the permission prompt only when you turn on **System notifications** or click **Allow notifications**.

You can use Cloud normally whether or not you allow notifications.

### Rules and states

| Situation | What you see | What you can do |
| - | - | - |
| Main switch on + Allowed | The three alert type switches; qualifying events show a banner | Turn off individual types |
| Main switch on + Not requested | The three alert types are hidden | Click **Allow notifications** |
| Main switch on + Not allowed | The three alert types are hidden | Click **System Settings** and allow notifications in the system |
| Main switch off | The three alert types are hidden and no banners appear | Turn the main switch back on; if permission has not been requested yet, turning it on also requests permission |
| Not supported | The main switch is unavailable | Use the in-app notifications list |

## Which events show system notifications

| Type | Events |
| - | - |
| Task completed | Task completed, Scheduled task completed |
| Needs your attention | Approval needed, Input needed, Action needed |
| Task issues | Task failed, Task interrupted, Scheduled task failed, Schedule paused |

Other notifications (such as a project missing environment variables, cloud server desktop traffic alerts and subscription-related alerts) are only recorded in the in-app notifications list and do not show a banner.

### When a banner appears

A new notification shows a banner only if all of the following conditions are met. Otherwise, it is only recorded in in-app notifications:

1. The main switch is on, and the system has allowed notifications.
2. The switch for the notification's type is on.
3. You are not currently viewing the page for this notification in the foreground.

Notifications that already exist when you open Cloud do not show a banner afterward. Whether a scheduled task notifies you of run results also depends on that scheduled task's own **Notifications** setting. See [Scheduled tasks](https://docs.aihubmix.com/en/cloud/automation/scheduled-tasks.md).

### Banner behavior

* **Clicking a banner**: opens the matching session or scheduled task and brings the window to the foreground.
* When several sessions finish at almost the same time, they are combined into one banner, **N tasks completed**. Clicking it opens the in-app notifications list. The in-app list still keeps each notification separately.
* Marking a **Needs your attention** notification as read only means you have seen it. It does not approve or handle anything for you.

### Closing the window and quitting the app

* When **Keep in the menu bar** is on in the desktop app (on by default), notifications still appear after you close the main window.
* After you quit the app completely, no system notifications appear. View notifications from that period in the in-app list.

## In-app notifications

**Settings › Personal › Notifications** lists in-app notifications, newest first, with unread items marked.

### List and filters

* At the top are the **All / Unread** filter, the **Mark all read** button and the gear **Notification settings**.
* Each row shows the title, the description (or the project name) and the time. Unread items have a **Mark as read** button.
* Click **Load more** at the bottom of the list to see older notifications.

### Click to open

| Object linked to the notification | After you click |
| - | - |
| Session / scheduled task / project | Opens the matching page |
| Project missing environment variables | Opens the project's environment settings page |
| Cloud server desktop traffic alert | Opens the cloud server page |
| Subscription-related alert | Opens the billing part of **Settings › Account** |
| Deleted session / project | Does not open anything and shows **This chat was deleted** or **This project was deleted** |

* Clicking first marks the notification as read, then opens the target.
* Notifications that can only be handled in the desktop app are labeled **Resolve in the desktop app** or **View in the desktop app** in the web app.

### Rules and states

| Situation | What you see | What you can do |
| - | - | - |
| No notifications at all | **No notifications yet** | Nothing needed |
| No unread notifications under the **Unread** filter | **No unread notifications** | Switch back to **All** |
| Everything loaded is read, but older unread notifications remain | **Everything loaded is read. Load more to check older ones.** | Click **Load more** |
| Loading or marking as read failed | **Couldn’t load notifications** or **Couldn’t mark as read: reason** | Click **Retry** or try again |

* After you click **Mark all read**, the unread count in the account menu, the avatar dot and the unread count on the Dock / tab disappear.
* Read status syncs with your account to your other devices.

## FAQ

### Why didn't a notification appear when a session finished?

Check these in order: whether **System notifications** is on, whether **System permission** is **Allowed**, and whether the **Task completed** type is on. For a scheduled task, check whether its **Notifications** setting is **All updates** (the default, **Important updates**, only notifies failures). Also check whether you were viewing that session in the foreground at the time.

### Can I still see notification records after turning off system notifications?

Yes. The in-app notifications list is independent of the system notifications switch.

### I already allowed notifications in system settings. Why does it still show "Not allowed"?

The status updates when you switch back to the Cloud window. On macOS, it may return to **Allowed** only after the next notification is delivered.

### If I mark an "Approval needed" notification as read, does the session continue?

No. Read only means you have seen it. You need to open the session to complete the approval.

## Related

* [General and Appearance](https://docs.aihubmix.com/en/cloud/settings/general.md)
* [Scheduled tasks](https://docs.aihubmix.com/en/cloud/automation/scheduled-tasks.md)
* [Needs your input](https://docs.aihubmix.com/en/cloud/sessions/user-intervention.md)
* [Archive](https://docs.aihubmix.com/en/cloud/settings/archived.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.