Changelog

Latest updates and improvements in the <inbox /> components category.

Follow us on X

All changelog posts

  • Notifications Schedule

    Subscribers can set weekly schedules for their notifications. Messages sent outside these times will be suppressed. But critical alerts will still be delivered. You can manage schedules through API, SDK, or Dashboard. The smart workflow delivery waits for subscribers to be available.

    Cover
    Note

    Requires <Inbox /> version 3.10.1 or higher

    Give your subscribers control over when they receive notifications with customizable availability schedules. Subscribers can set their preferred hours for notifications. The system will then block messages sent outside those times. This helps them balance work and life. It also makes sure they always get important alerts.

    Weekly Schedule Configuration

    Subscribers can create a full weekly schedule right from their inbox settings. They can pick the days and times they want to get notifications. Subscribers can set their availability from Monday to Friday, 9 AM to 5 PM. The system will then ignore notifications sent by email, push, SMS, or chat outside these hours. Time ranges are set in 30-minute increments. They follow the subscriber's time zone. For example, a user in Europe/Warsaw gets notifications only during their local hours.

    Availability Preferences

    Copy Schedule Across Days

    With the copy feature, you can set up the same schedule for multiple days. Subscribers can set their Wednesday hours from 8 AM to 4 PM. With one click, they can easily apply those hours to Monday, Tuesday, Thursday, and Friday. There is no need to configure each day individually.

    Copy availability to other days

    Multiple Time Ranges Per Day

    Subscribers can set several availability windows for one day, which helps them manage complex schedules. For example, a person may be free for morning updates from 8 AM to 10 AM or from 1 PM to 5 PM. They won’t send notifications during lunch or meetings.

    Smart Workflow Delivery

    The system evaluates availability at the exact moment of delivery for each workflow step, which means notifications in multi-step workflows adapt dynamically to subscriber schedules. A workflow with a delay step could still be delivered successfully if the subscriber returns to their availability window when the delay is complete.

    Smart Workflow Delivery

    You can also configure digest and delay steps to automatically extend until the subscriber is back within their scheduled hours, ensuring messages are delivered when they're most likely to be seen.

    Critical Notifications Always Deliver

    Workflows labeled as critical—like security warnings, billing failures, or system alerts—go straight to delivery. This means urgent messages arrive right away, without any delays.

    In-app notifications always come through, no matter the schedule settings. They don't interrupt subscribers, so users can check them whenever they want.

    Full Management Control

    Subscriber schedules can be managed through the API and SDK. You can also view and edit them directly from the Dashboard. You can set a default schedule for subscribers who haven't set their own.

    Notification schedule dashboard management

    This eliminates the need for migrations for existing users. The activity feed logs when notifications are missed due to scheduling limits, making it easier to fix delivery issues and understand user actions.

    The new useSchedule hook in the React SDK provides the subscriber's current schedule and an update function, making it easy to create custom schedule interfaces.

    Check the documentation to explore the available configurations for setting up the notification receiving schedule (subscriber availability preferences).

    Improvements (2)
    • Translations CLI Integration: The CLI lets you easily sync translations by pulling them from Novu Cloud to your project and pushing updates back with simple commands.
    • Translations API

  • <Inbox /> Updates - v3.10.1

    There are three major workflow management upgrades: custom sorting for workflow preferences, complete subscriber schedule control through the Inbox component, dashboard, and React hooks, and permanent notification deletion beyond just archiving.

    Cover
    Note

    Requires <Inbox /> version 3.10.1 or higher

    Custom Workflow Priority Display

    Organize workflow preferences exactly how your users need them. The preferencesSort prop lets you customize the order of workflows in the subscriber preferences list by accepting a custom comparison function similar to JavaScript's Array.sort() method.

    This enables you to highlight essential workflows at the top, sort alphabetically, prioritize by tags, or implement any custom sorting logic your application requires.

    Sorting Preferences

    You can also use preferencesSort it together with preferenceGroups to apply sorting within each group, giving you complete control over both organization and order.

    Learn more about configuring preference sorting in the documentation.

    Subscriber Schedule Management

    The notification scheduling system allows subscribers to choose when they get messages. They can set specific days and times, plus multiple time windows based on their time zone.

    Users can configure weekly schedules and replicate settings across days. Messages are blocked outside these hours. However, critical notifications, like security alerts, will still be delivered right away. In-app notifications are always on.

    The system has management tools through an API, SDK, and Dashboard. It also logs activities and includes a React SDK for custom interfaces.

    Dashboard Schedule Editor

    Update subscriber schedules directly from the preferences tab with instant visual feedback.

    Availability management from the dashboard

    Default Schedule Setup

    Configure default notification schedules that automatically apply to new subscribers, with individual customization available as needed.

    Users' availability schedule

    useSchedule Hook

    A New React hook provides programmatic schedule control with built-in appearance customization and localization support for custom interfaces.

    Learn more

    Appearance Customization

    Learn more about dedicated appearance props for schedule-related elements.

    Permanent Notification Deletion

    Unlike archiving, which retains notifications in storage, permanent deletion removes them completely for cleaner notification management and better privacy compliance.

    Notification deletion
    Note

    Deletion is irreversible—deleted notifications cannot be recovered.

  • Notification Severity

    Notification Severity lets you classify workflows as High, Medium, Low, or None importance. High/medium notifications get color-coded visual cues (red/orange), the bell icon changes color based on highest unread severity, and you can filter notifications by priority level in tabs. Available through dashboard settings, API, and template variables.

    Author:Paweł Tymczuk
    Paweł Tymczuk
    Cover

    Note: Requires <Inbox /> version 3.9.1 or higher


    Prioritize user attention with notification classification that helps users quickly identify and respond to critical messages. Set severity levels for any workflow to ensure urgent communications get the immediate attention they deserve.

    Visual Priority Indicators

    Notifications now display with color-coded visual cues based on their importance level. High-severity notifications appear with a red accent, medium-severity with orange, and low-severity messages remain neutral.

    Your users can instantly spot critical alerts in their notification feed without reading every message.

    Smart Bell Icon Status

    The notification bell automatically adapts its color to reflect the highest priority unread message.

    When users have critical notifications waiting, the bell glows red to signal immediate attention is needed, even before they open their inbox.

    Flexible Severity Filtering

    Create dedicated tabs in your inbox that filter notifications by severity level. Build a "Critical Alerts" tab for high-priority messages or a "Security" section for account-related warnings. Users can focus on what matters most while keeping less urgent notifications organized and accessible.

    Headless API Support

    Access severity data programmatically through our API for custom notification interfaces. The severity field is available on every notification object, enabling conditional rendering and custom styling in your own UI components.

    Template Personalization

    Use workflow severity directly in your message templates with the {{workflow.severity}} variable.

    Create dynamic content that adapts based on the notification's importance level, such as "This is a high-priority message regarding your account."

    Configure severity levels for any workflow directly from the Novu dashboard under workflow settings.

    Existing workflows default to "None" severity, giving you full control over which messages receive priority treatment.

    Learn more