Skip to main content

Preferences UI Examples

Built-In Preferences (Inside Inbox)

The Inbox component includes a built-in Preferences panel. Subscribers access it via the settings icon:

Standalone Preferences Component

Render the Preferences panel independently:

Preferences with Filtering

Filter which workflows appear in the Preferences panel:

Preference Groups

Group workflows in the Preferences panel:

Custom Preferences UI with @novu/js

Build a completely custom preferences interface:

Next.js Example

Important Notes

  • Read-only workflows (readOnly: true) are hidden from the Preferences UI — subscribers cannot change them. It signifies that workflow is critical
  • The Preferences component requires a parent <Inbox> wrapper for the Novu context
  • Preferences are per-subscriber and per-environment (dev, staging, prod) and scoped per context
  • Changes made via the UI are immediately reflected in notification delivery