All changelog posts

• Oct 9, 2025

  Throttle Step

  The new Throttle Step allows you to limit the frequency of a workflow execution for each subscriber within a specified time window. This will prevent duplicate or excessive notifications across all channels. You can use fixed or dynamic windows. Perfect for managing high-frequency alerts, cron jobs, or multi-project notifications.

  Author:

  Dima Grossman

  • Workflow Steps
  • Improvement

  

  The new Throttle step in the Novu workflow editor allows you to limit the number of notifications a subscriber receives within a specified time frame, ensuring they receive the right amount, neither too many nor too few.

  When a trigger fires repeatedly (e.g., from cron jobs or high-frequency alerts), throttling ensures that subscribers don’t receive duplicate messages across any channel.

  

  You can now:

  • Configure throttling directly in the workflow editor.
  • Define Fixed or Dynamic throttle windows.
  • Limit executions by subscriberId or add a secondary grouping key from your payload (e.g., payload.projectId).
  • Prevent notifications from executing beyond your defined threshold (even for critical workflows).
  • Transparently control frequency across all channels (email, in-app, SMS, chat, push).

  Configuration options:

  • Fixed window: Set a predefined duration (e.g., “1 per hour”) with an execution threshold.
  • Dynamic window: Define flexible time ranges using trigger payloads (payload.throttleUntil or payload.customWindow).
  • Group throttling by: Combine subscriber and payload-level keys for granular control (e.g., per project or account).

  Learn more by visiting the Throttle Step documentation →

  Improvements (3)

  • Schemas now support null values for optional fields in workflows, ensuring executions no longer fail when data is intentionally unset.

  • Add support for excluding specific subscribers from topic-triggered workflow fanouts using an optional exclude array.

  • Add support for defining a custom display order of workflows in the Preferences UI, allowing prioritized workflows to appear at the top.

  Fixes (1)

  • fix(dashboard-ui): Unify and align all dashboard tables (Workflows, Subscribers, Topics, Topic Subscriptions) using the new OriginUI table component for consistent layout, pagination, and record visibility.

• Oct 8, 2025

  Translations in Email Layouts

  Translations support in email layouts. Localize headers, footers, and templates once - and reuse them across all your workflows.

  Author:

  Paweł Tymczuk

  • Translations
  • Email

  You can now add translations directly at the email layout level. This means that when you configure a default or reusable email layout in your organization environment, you can also provide localized versions of that layout.

  Previously, translations were only available on a per-email-step basis within workflows. Now, layouts themselves can be localized once, and the translations will automatically apply to any email workflow that uses that layout.

  How It Works

  1. Go to Workspace → Layouts and create or edit a layout.
  2. Add translations for your chosen locales (JSON format).
  3. Any workflow email step using that layout will render the correct translation automatically, based on the subscriber’s locale.

  Layout and step content are translated independently, then combined during rendering to deliver fully localized emails.

• Oct 6, 2025

  Scheduled Delay

  Schedule your workflows with precision - pause until the exact minute, hour, or weekday in each subscriber’s local time, and even align delivery with their working hours.

  Author:

  Paweł Tymczuk

  • Workflow Steps
  • Delay

  

  You can now schedule workflow pauses using an intuitive time selector - allowing you to delay messages until an exact time, day, or week in your subscriber’s local timezone.

  

  This new Scheduled Delay option (when configuring the Delay step) provides developers with fine-grained, time-aware control over workflow timing, allowing you to match your subscribers’ schedules, respect working hours, and ensure messages arrive at the optimal moment, not just after a fixed interval.

  What you get:

  • Two delay modes: choose between
    • Regular Delay: wait a fixed duration (e.g. “5 minutes”)
    • Scheduled Delay: wait until a specific time or date pattern
  • Flexible scheduling options:
    • Until minute — delay until the next minute mark
    • Until hour — at X minute(s) of the hour
    • Until day — at X hour(s) : X minute(s)
    • Until week — choose one or more days (Mon–Sun) at X hour(s) : X minute(s)
    • Until month — choose specific day(s) of the month and time of day
  • Time zone–aware delivery: All delays are evaluated and executed in the subscriber’s local time zone.
  • Working hours support: toggle “Extend to subscriber’s schedule” to automatically hold delivery until the subscriber’s next available time window.
  • Configurable limits: by default, delays can extend up to 1 day (contact support to extend for longer intervals)

  Example use cases:

  • Send a weekly digest every Friday at 9:00 AM subscriber local time.
  • Deliver a trial reminder at 8:00 AM on the day of expiry.
  • Respect user schedules by delaying notifications until working hours.

  How to use it:

  In the workflow editor → add a Delay step → select “Scheduled” → configure your timing (minute, hour, day, week, or month) and enable “Extend to subscriber’s schedule” if needed.

• Oct 2, 2025

  Email Activity Tracking

  Activity tracking gives you visibility into what happens to notifications after they are sent to the subscriber. With it, Novu receives and processes real-time events from third-party providers, so that you know when the notification is delivered, opened, clicked, or bounced.

  Author:

  George Djabarov

  • Email
  • Analytics

  

  Now, you can track real-time delivery and engagement events from email providers right in Novu. Events such as delivered, opened, clicked, and bounced are turned into a uniform set of statuses.

  You can see these in your Activity Feed, workflow traces, and outbound webhooks.

  Before, you only knew if a message was “sent.” You now have complete visibility. You can see if the recipient received your message, opened it, clicked it, or rejected it.

  This helps you resolve issues, measure engagement, and create more effective notification experiences.

  How to Use It

  1. Go to your Integrations Store in the Novu dashboard.
  2. Connect your email provider (SendGrid, Mailgun, Resend, Amazon SES).
  3. Scroll to Email Activity Tracking and toggle it on.
     • Novu will automatically configure webhooks using your API key.
     • If auto-config fails, follow the manual setup guides.

  

  Once enabled, events flow into:

  • Activity Feed → real-time status updates.
  • Outbound webhooks → forward normalized events into your own systems (logging, analytics, workflow triggers).

  Supported Events

  • Delivered
  • Opened
  • Clicked
  • Bounced
  • Delayed
  • Rejected
  • Complaint
  • Unsubscribed

  Links & Resources

  • Docs: Activity Tracking
  • Email Provider Integration Setup

• Sept 25, 2025

  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.

  Author:

  Paweł Tymczuk

  • <Inbox /> Components
  • Subscriber Preferences

  

  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.

  

  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.

  

  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.

  

  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.

  

  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

• Sept 25, 2025

  <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.

  Author:

  Paweł Tymczuk

  • <Inbox /> Components
  • @novu/js
  • @novu/react
  • @novu/nextjs

  

  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.

  

  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.

  

  Default Schedule Setup

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

  

  useSchedule Hook

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

  Learn more

  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.

  

  Deletion is irreversible—deleted notifications cannot be recovered.