Tenant alerts and notifications

Alert channels in v1

• In-app saved-search modules on `/tenant/home`.
• Email digests for active saved searches when enabled by ops.
• Push alerts for saved-search matches (requires browser notification permission).
• Role-safe links back to exact matches.

Frequency behaviour

• Instant: near-real-time, rate-limited.
• Daily: summary of new matches since last send.
• Weekly: wider digest for slower-moving searches.
• Push (saved-search): `Instant` or `Daily digest`.

Push settings (saved searches)

• Open `/tenant/saved-searches` and use **Notification settings**.
• Controls available:
• Enable/disable saved-search push alerts.
• Frequency: `Instant` or `Daily digest`.
• Quiet hours (local timezone) to suppress sends overnight.
• Defaults for new tenants:
• Alerts enabled
• Instant mode
• Quiet hours off

Quiet hours and daily mode

• Quiet hours suppress push sends during your selected window.
• Overnight windows are supported (for example `22:00` to `07:00`).
• Start and end times must be different.
• Daily mode sends at most one saved-search push per local day when new matches exist.
• If no new matches are found, no push is sent.

How to keep alerts useful

1. Keep search radius and budget realistic.
2. Disable searches that are too broad.
3. Rename searches so digest sections are immediately clear.
4. Review and pause stale searches monthly.

Disable alerts safely

• Use saved-search settings in app.
• Email digests include a disable link per search.
• If you disabled by mistake, re-enable from saved searches manager.

Common confusion

• “Why no email today?”
• No new matches since your last baseline.
• Alerts may be paused or globally disabled by ops.
• “Why many emails?”
• Multiple active high-volume searches.
• Frequency set to instant for broad filters.

Related guides

• Tenant core workflows
• Tenant success tips