> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/en/start/notifications.md).

# Notification Center

The Notification Center bell in the top-right corner of the console—system and organization announcements, notification types (human handoff, quota reminders, connector activation, and more), maintena

The <mark style="color:blue;">Notification Center</mark> is the bell in the top-right corner of the console. It brings together announcements from the MaiAgent platform, announcements for your organization, and system notifications, such as human handoff notifications when a conversation is assigned to you or reminders that your personal quota is running low. All signed-in members can see the bell; the notifications it contains depend on your **current organization** and role.

## Open the Notification Center <a href="#open-notification-center" id="open-notification-center"></a>

Click the bell icon in the top-right corner of the console. The red number on the bell is the **unread** notification count (shown as 99+ above 99), covering system announcements and notifications for the current organization. While the page is open, the unread count updates automatically about once a minute. It also refreshes when you return from another browser tab.

The Notification Center has two tabs. The number after each tab name is the total number of notifications currently visible in that tab:

| Tab                                                         | Contents                                                                                                                                                            |
| ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">System Announcements</mark>       | Announcements from the MaiAgent platform for all users, such as system maintenance, feature updates, and real-time status reports on model service delays or issues |
| <mark style="color:blue;">Organization Announcements</mark> | Announcements for the current organization, including announcements published by its owner and notifications automatically sent by the system based on your work    |

## Types of notifications <a href="#notification-types" id="notification-types"></a>

Common notifications in the <mark style="color:blue;">Organization Announcements</mark> tab are listed below. Each notification has a display period and disappears from the list automatically when it expires.

| Notification                                                                                                                                                                                                       | Recipients                                                                             | Display period                    |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- | --------------------------------- |
| Announcements published by the organization owner in [Announcement Management](https://docs.maiagent.ai/maiagent-user-guide/en/org/overview/announcements.md)                                                      | All members, or the groups (roles) and members specified when publishing               | The period set when publishing    |
| <mark style="color:blue;">Human Handoff Notification</mark>                                                                                                                                                        | The support specialist assigned to the conversation and the configured copy recipients | 7 days                            |
| <mark style="color:blue;">Personal Quota Running Low</mark>, <mark style="color:blue;">Personal Quota Expiring Soon</mark>                                                                                         | The member whose quota meets the reminder conditions                                   | 7 days                            |
| <mark style="color:blue;">Low Credits Balance</mark>, <mark style="color:blue;">Credits Expiring Soon</mark>, <mark style="color:blue;">Payment Failed</mark>, <mark style="color:blue;">Auto Top-Up Failed</mark> | Organization owner                                                                     | 7 days                            |
| <mark style="color:blue;">Data Retention Warning</mark>                                                                                                                                                            | Organization owner                                                                     | Until the scheduled deletion date |
| <mark style="color:blue;">Connector Activated</mark>                                                                                                                                                               | The member who previously requested activation of the connector                        | 7 days                            |

For configuring human handoff notification recipients, see [Human Handoff Support Notifications](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/human-handoff/handoff-notification.md). For quota reminder conditions, see [Member Credits Quota Management](https://docs.maiagent.ai/maiagent-user-guide/en/others/credits/member-credit-quota.md). For notifications that also send Email and other occasions when the system sends mail, see [System Notifications and Email](https://docs.maiagent.ai/maiagent-user-guide/en/start/system-emails.md).

## View notifications and mark them as read <a href="#read-notifications" id="read-notifications"></a>

### Read the list <a href="#list-layout" id="list-layout"></a>

* **Unread** notifications have bold titles and a small dot on the left.
* Higher-priority notifications have a label: <mark style="color:blue;">Important</mark> (such as human handoff notifications and quota reminders) or <mark style="color:blue;">Urgent</mark> (such as data retention warnings).
* Each entry shows a content summary and how long ago it was published. If the publisher chooses to disclose their identity, the <mark style="color:blue;">Publisher</mark>'s name and Email are shown.
* The list loads 10 entries at a time and automatically loads more as you scroll down. At the end, it shows “No more data.” If there are no notifications, it shows <mark style="color:blue;">No announcements</mark>.

### Mark as read <a href="#mark-as-read" id="mark-as-read"></a>

Click a notification to open a detail dialog showing its full content and display period. If the notification includes a link, link text appears at the bottom of the dialog, defaulting to <mark style="color:blue;">Learn More</mark>. For human handoff notifications, it is <mark style="color:blue;">Take Over</mark>; clicking it opens the conversation.

Click <mark style="color:blue;">Got It</mark> or the close button in the top-right corner to mark the notification as read and reduce the red count. Read notifications remain in the list and can be reopened at any time during their display period.

### Mark all as read <a href="#mark-all-as-read" id="mark-all-as-read"></a>

When you have unread notifications, <mark style="color:blue;">Mark All as Read</mark> appears in the top-right corner of the Notification Center. Clicking it marks all notifications visible to you in **System Announcements and the current organization** as read, and displays <mark style="color:blue;">All marked as read</mark>. Notifications in other organizations are unaffected; handle them separately after switching organizations.

## System announcements that appear automatically <a href="#banner-and-popup" id="banner-and-popup"></a>

Two types of system announcements appear proactively if you have not read them, without opening the bell:

| Type               | How it appears                                                                                           | How to dismiss it                                                                     |
| ------------------ | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| System maintenance | A banner at the top of the page content, showing one announcement at a time                              | Click the close button on the right of the banner; this also marks it as read         |
| Feature update     | A dialog that appears automatically when you sign in (or reload the console) or navigate to another page | Click <mark style="color:blue;">Got It</mark> or close it; this also marks it as read |

**When there are multiple system maintenance announcements:** The banner shows only the highest-priority announcement (<mark style="color:blue;">Urgent</mark> before <mark style="color:blue;">Important</mark>, followed by <mark style="color:blue;">Normal</mark>; newer announcements come first within the same priority). Long content is truncated; hover over it to see the full title and content. The others are grouped under “N more announcements” on the right of the banner. Click it to expand a list below the banner, with each row showing a title and start time. You can also close announcements individually in this list. Closing the current announcement brings up the next one.

**When feature update dialogs appear:** The system checks only when you sign in or reload the console, or navigate to another page. A dialog will not suddenly appear while you are working on the same page. At most one dialog appears at a time, with the rest saved for the next page navigation. If an organization announcement [dialog](#org-announcement-reminders) is also due, the organization announcement appears first.

## Proactive reminders for organization announcements <a href="#org-announcement-reminders" id="org-announcement-reminders"></a>

By default, organization announcements appear only in the bell's <mark style="color:blue;">Organization Announcements</mark> tab. If the organization owner sets the [Reminder Method](https://docs.maiagent.ai/maiagent-user-guide/en/org/overview/announcements.md#reminder-method) to <mark style="color:blue;">Toast</mark> or <mark style="color:blue;">Dialog</mark> when publishing, you will see it proactively the next time you sign in (or reload the console) or navigate to another page. Each toast appears only once. A dialog reappears on refresh or page navigation until you dismiss it. Both types of reminder have <mark style="color:blue;">Organization Announcement</mark> at the top.

### Dialog <a href="#org-announcement-modal" id="org-announcement-modal"></a>

The full announcement appears in the center of the screen. Clicking <mark style="color:blue;">Got It</mark>, the close button in the top-right corner, or the area outside the dialog, or pressing Esc, dismisses it and marks it as read so it will not appear again.

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-d50d719f90d656b0e67ae56dd3a0a285645c3ae2%2Fannouncement-org-modal.png?alt=media" alt="An announcement dialog in the center of the screen, labeled Organization Announcement at the top, with a Got It button at the bottom"><figcaption><p>Organization announcement dialog</p></figcaption></figure>

### Toast <a href="#org-announcement-toast" id="org-announcement-toast"></a>

A toast appears in the top-right corner of the screen with the announcement title. A countdown in the bottom-right corner says “Disappears in N seconds,” and the progress bar at the bottom shrinks accordingly. The duration is set by the publisher.

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-00c78dea43c73df0c70d2a8f98f2120b7003f418%2Fannouncement-org-toast.png?alt=media" alt="A toast labeled Organization Announcement, showing the announcement title, a View button, and Disappears in 8 seconds"><figcaption><p>Organization announcement toast</p></figcaption></figure>

* **Pause the countdown:** Hover over the toast or give it keyboard focus to pause the countdown and display “Paused (N seconds total).” The countdown also pauses when you switch to another browser tab.
* **Read the full content:** Click <mark style="color:blue;">View</mark> to open the full announcement. It is marked as read only after you close it. If the announcement has been deleted or disabled, you will see “Unable to open announcement: This announcement has been deleted or disabled.”
* **Does not count as read:** Clicking the close button in the top-right corner or letting the countdown finish dismisses the toast, but the announcement remains unread in the <mark style="color:blue;">Organization Announcements</mark> tab. You can open it from the bell later.
* **Appears only once:** Once a toast has appeared in one tab or on one device, it will not appear again in other tabs or on other devices.

{% hint style="info" %}
At most one dialog and one toast appear per page navigation; the rest wait until the next navigation. If both are due, the toast waits until you close the dialog before appearing and starting its countdown from the beginning.
{% endhint %}

## Announcements visible to new members <a href="#new-members" id="new-members"></a>

To avoid overwhelming new members with old announcements as soon as they join:

* **When an account is registered**, system announcements still within their display period are automatically considered read.
* **When a member joins an organization**, that organization's announcements still within their display period are automatically considered read.

These announcements remain in the Notification Center list and new members can open them, but they do not count toward the red number or interrupt members with banners, dialogs, or toasts. Only announcements published **after** joining appear as unread.

## Frequently asked questions <a href="#faq" id="faq"></a>

### A colleague mentioned an announcement, but it is missing from my Notification Center. Why? <a href="#faq-missing-announcement" id="faq-missing-announcement"></a>

Check the following in order: Are you in the same organization, as shown in the top-left corner? (Organization announcements show only those for the current organization.) Was the announcement sent only to specific roles or members? Has its display period expired?

### Why did the red number change after I switched organizations? <a href="#faq-count-changes" id="faq-count-changes"></a>

This is expected. The unread count covers only system announcements and notifications for the **current organization**, with a separate count for each organization.

### How do I publish an organization announcement? <a href="#faq-publish" id="faq-publish"></a>

Organization owners can go to <mark style="color:blue;">Organization Settings</mark> → <mark style="color:blue;">Organization Overview</mark> and click <mark style="color:blue;">Announcement Management</mark> under <mark style="color:blue;">Management Actions</mark> to create an announcement. They can configure its <mark style="color:blue;">Reminder Method</mark>, display period, <mark style="color:blue;">Priority</mark>, multilingual content, and <mark style="color:blue;">Target Audience</mark>. Other roles with Organization Overview permission can only view announcements. For all fields and procedures, see [Announcement Management](https://docs.maiagent.ai/maiagent-user-guide/en/org/overview/announcements.md).

## Further reading <a href="#further-reading" id="further-reading"></a>

* [System Notifications and Email](https://docs.maiagent.ai/maiagent-user-guide/en/start/system-emails.md)
* [Human Handoff Support Notifications](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/human-handoff/handoff-notification.md)
* [Member Credits Quota Management](https://docs.maiagent.ai/maiagent-user-guide/en/others/credits/member-credit-quota.md)
* [Manage Connectors (Admin)](https://docs.maiagent.ai/maiagent-user-guide/en/work/maigpt/connectors/connectors-admin.md)
* [Personal Account Settings](https://docs.maiagent.ai/maiagent-user-guide/en/start/profile.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/en/start/notifications.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
