# Employee Notifications {#employee-notifications}


Configure notification preferences and view notification history.


## Overview {#overview}


The employee notification system provides:

- Real-time in-app notifications
- Configurable notification preferences per employee
- Notification history and read/unread tracking


## Notification Settings {#notification-settings}


Each employee can customize which events trigger notifications:

| Setting               | Default | Description                         |
| --------------------- | ------- | ----------------------------------- |
| `assignTask`          | ✅      | Notified when assigned to a task    |
| `unassignTask`        | ✅      | Notified when removed from a task   |
| `createdTask`         | ✅      | Notified when a new task is created |
| `mentionedInComment`  | ✅      | Notified when @mentioned            |
| `commentOnTask`       | ✅      | Notified on new task comments       |
| `statusChangeForTask` | ✅      | Notified on task status changes     |


## Notification Types {#notification-types}


- **In-App** — displayed in the bell icon dropdown
- **Email** — sent to the user's email address (requires SMTP configuration)


## Viewing Notifications {#viewing-notifications}


1. Click the 🔔 bell icon in the header
2. View unread notifications
3. Click a notification to navigate to the related entity
4. Mark individual or all notifications as read


## API Reference {#api-reference}


See [Comment & Mention Endpoints](https://sourcey-gauzy.pages.dev/api/comment-mention-endpoints/index.md) for notification-triggering events.


## Related Pages {#related-pages}


- [Entity Subscriptions](https://sourcey-gauzy.pages.dev/features/entity-subscriptions/index.md) — subscribe to entity changes
- [Custom SMTP](https://sourcey-gauzy.pages.dev/features/custom-smtp/index.md) — email notification delivery
- [Email Templates](https://sourcey-gauzy.pages.dev/features/email-templates/index.md) — notification email templates