Notifications

Villva ERP keeps people informed through notifications. This page explains how they work and what you can control, both as a user and as an admin.

Channels

Notifications reach you on two channels:

• In-app: the bell icon in the header (see Navigating the app).
• Email: delivered to your inbox.

There is no SMS anywhere in the product. Push is reserved for the future but not available today.

When a module needs to inform you, an in-app entry appears immediately and any email is sent in the background so nothing is delayed. Every notification only ever targets a person in the same organisation as the event.

The in-app notification center

• The bell shows your recent notifications and an unread count.
• New notifications stream in live: no refresh needed.
• Opening one marks it read; “mark all read” clears the count.
• Clicking a notification jumps to the related record.
• A full notifications page lets you filter by type and date.

You only ever see your own notifications.

Your notification preferences

📷 Image placeholder

Add a screenshot here: the per-user notification preferences screen listing each category with its email toggle, and the always-on in-app entries for critical categories.

You choose which categories reach you on which channel.

1. Open your notification preferences from your profile.
2. For each category, turn email on or off. (Sensible defaults are set when your account is created.)
3. Save.

In-app alerts for critical categories: security, password reset, an approval assigned to you, are always on and cannot be switched off. You can reset to defaults at any time. Your preferences are yours alone; an admin cannot read another person’s preferences.

Quiet hours (do-not-disturb)

Set quiet hours so you are not pinged after work.

• Choose a start and end time (in your own or your organisation’s timezone) and toggle per day of week.
• Non-critical notifications are held and delivered after your window ends.
• Critical categories (security, password reset) always come through.

Unsubscribe

Non-transactional emails carry a one-click unsubscribe link that turns off that category for you without needing to sign in. Transactional messages (like security and password reset) cannot be unsubscribed, those show a note explaining why instead.

For admins

Email branding

Apply your brand to every outgoing email:

• Set the logo, sender display name, reply-to address and a footer disclaimer.
• A live preview shows your theme against a sample email.

This is separate from your in-app branding because email clients have stricter rules.

Notification templates

Notification copy comes from templates with merge fields, so modules supply only the data. As an Org Admin you can edit your organisation’s overrides in a template editor:

• A merge-field picker shows the fields available for each template type.
• Save is blocked if a required merge field is missing.
• A live preview renders with sample data, and you can reset to the default at any time.

Emails always go out with both an HTML and a plain-text version, and render in the recipient’s language where available.

Delivery, retries and the suppression list

• Transactional email is sent reliably in the background. A temporary failure is retried automatically; a permanent failure (an invalid address) is marked failed and not retried. Admins can see delivery status.
• When an email hard-bounces or a recipient marks it as spam (a complaint), that address is added to your organisation’s suppression list so you stop mailing it.
• You can view and manage the suppression list: see each entry’s email, reason (bounce / complaint / manual), date and source; search and filter; manually add or remove an address (a removal requires a reason note, which is logged); and export the list.
• The suppression list is specific to your organisation and never mixes with another’s.