Notifications¶

Open Settings > Notifications to configure push, browser, and in-window alerts.

Relay Notifications settings showing push, browser, and per-message alert controls.

You can enable alerts for mentions and highlights, private messages, replies, reactions, or every message. Per-conversation controls override broad preferences, while mute and freshness checks still apply.

In-window alerts can remain visible for 1–3600 seconds. Clicking one opens its conversation and, when available, focuses the related message. Relay includes several sounds and, on private instances with uploads enabled, accepts a custom MP3, WAV, or Ogg/Opus file up to 2 MB and 10 seconds.

Browser audio preview grants the interaction needed by some browsers. Operating-system push notifications use the platform's own sound behavior. Networks supporting IRCv3 invite-notify can also produce invitation alerts.

Permissions and delivery¶

Enable the desired browser/push control from Settings > Notifications and accept the browser's permission prompt for your Relay server origin. If permission was denied, change it in the browser's site settings and retry. Push requires a supported secure context and service worker; an installed PWA may be required on mobile platforms. Also allow notifications in the operating system and check focus/do-not-disturb modes.

Test with a new private message or mention from another account while Relay is in the background. Check browser notifications, push and in-window alerts separately; they are distinct delivery paths. Muted conversations, current focus and stale/backfilled messages can suppress delivery. Use sound preview after interacting with the page to unlock audio playback. If delivery still fails, follow notification troubleshooting.