# Entity Subscriptions {#entity-subscriptions}


Subscribe to entities to receive notifications when changes occur.


## Overview {#overview}


Entity subscriptions allow users to watch specific tasks, projects, or other entities and receive notifications when changes happen — similar to "Watch" functionality in GitHub.


## Subscription Types {#subscription-types}


| Type         | Description                        |
| ------------ | ---------------------------------- |
| `COMMENT`    | Notify when new comments are added |
| `STATUS`     | Notify when status changes         |
| `ASSIGNMENT` | Notify when assignees change       |
| `ALL`        | Notify on all changes              |


## How to Subscribe {#how-to-subscribe}


1. Open the entity detail view (e.g., task, project)
2. Click the **Subscribe** / 🔔 bell icon
3. Select the subscription type


## Notification Delivery {#notification-delivery}


Subscription notifications are delivered through:

- **In-app notifications** — bell icon in the top bar
- **Email notifications** — if configured in employee notification settings


## API Reference {#api-reference}


See [Entity Subscription Endpoints](https://sourcey-gauzy.pages.dev/api/entity-subscription-endpoints/index.md) for the API documentation.


## Related Pages {#related-pages}


- [Employee Notifications](https://sourcey-gauzy.pages.dev/features/employee-notifications/index.md) — notification settings
- [Comments & Mentions](https://sourcey-gauzy.pages.dev/features/comments-and-mentions/index.md) — commenting system