Snooze notifications
Allow users to temporarily hide notifications and resurface them later using built-in snooze functionality in the Inbox component.
The <Inbox /> component includes built-in support for snoozing notifications, which can be used to temporarily dismiss notifications and have them reappear at a more convenient time.
How snooze works
When a subscriber snoozes a notification:
- It is temporarily removed from the general list.
- It appears in the Snoozed tab.
- It reappears in the general list after the specified time elapses.
During the snooze period, the notification cannot be marked as read, unread, or archived. All of these behaviors are handled automatically by the Inbox component.
How to snooze a notification
All dates and times are interpreted in your subscriber's local timezone. They can snooze a notification directly from the Inbox using one of the following options:
- Preset options:
- An hour from now
- Tomorrow
- Custom date and time:
- A built-in date and time picker allows users to select a specific future time.
The minimium snooze time must be at least 3 minutes in the future. While the maximum duration a notification can be snoozed depends on your cloud workspace plan:
- Free: Up to 24 hours per notification
- Trial: Up to 90 days during the 14-day trial, same as Pro
- Pro / Team: Up to 90 days
- Enterprise: Defaults to 90 days, extendable on request
While the Inbox component handles snoozing automatically, the JavaScript SDK also exposes .snooze() and .unsnooze() methods on the notification object to build custom snooze functionality.
This lets you create custom UI elements or workflows that trigger snooze actions outside of the default menu.
Managing snoozed notifications
The Inbox component includes a dedicated Snoozed tab that automatically displays notifications scheduled to reappear later. From this tab, users can review all snoozed notifications and take further actions as needed.
Users can unsnooze a notification at any time, which immediately returns it to the All tab. Once unsnoozed, the notification regains its standard behavior. It can be marked as read, unread, or archived like any other item.
| Action | Result |
|---|---|
| Manual unsnooze | Restores the notification exactly as it was: same tab, same read/unread state. If it was read before snoozing, it re-enters the All tab still marked read. |
| Automatic unsnooze (timer expires) | Re-delivers the notification to All as a new, unread item with an updated delivery timestamp. |
This logic is built into the component and does not require any additional configuration. Notifications automatically reappear in the All tab once their snooze duration elapses.