Skip to main content

Requirements

@novu/react requires React 18.0.0 or later (^18.0.0 or ^19.0.0). React 17 and earlier versions are not supported. When rendering Inbox components, you also need react-dom at a matching version.

Components

The @novu/react package provides React components for building notification UIs.

Inbox

The main component for displaying notifications.

Props

Usage

Appearance Configuration

Variables

Elements

Bell

A customizable notification bell component.

Props

Usage

Notifications

A component for rendering a list of notifications.

Props

Usage

NotificationItem

The built-in notification item as a React component. Render it inside renderNotification to keep the default look, or pass children to arrange its parts yourself. The parts are NotificationItem.Avatar, Content, Text, Subject, Body, DefaultActions, CustomActions, Date and Dot.

Props

Usage

Render props such as renderNotification are render functions: they run on every notification update and on every re-render of your component, and React reconciles what they return, so state inside them survives updates.

InboxContent

A component for building custom notification inboxes.

Props

Usage

Subscription

Props

Appearance configuration

Usage