Availability
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
- 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.
Rules and states
Which events show system notifications
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:- The main switch is on, and the system has allowed notifications.
- The switch for the notification’s type is on.
- You are not currently viewing the page for this notification in the foreground.
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
- 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
- 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.