> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainloop.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Notifications

<Note>
  This feature is only available on Chainloop's platform [paid plans](https://chainloop.dev/pricing).
</Note>

## Overview

Notifications are a powerful feature in Chainloop that keeps users informed about important events and updates within the platform. They help ensure that users stay up-to-date with the latest activities related to their projects, workflows, and compliance status.
Notifications can be configured to alert users about various events, such as:

* System status events (like storage backend issues)
* Product Compliance changes
* Product releases
* etc.

## Configuring Notifications

Notification integrations can be configured through the Platform UI, in the [integrations section](./integrations), where Fan-out integrations can be configured as well.
The configuration of each notification channel may vary, depending on the specific requirements of the channel. Some channels may require additional setup, such as providing API keys or webhook URLs. They are kept safe in the [platform secret storage](/guides/deployment/platform#step-6-configure-secret-manager-in-platform-chart).

<img src="https://mintcdn.com/chainloop/chU1iZMI9rskcnzW/concepts/img/integrations-2.png?fit=max&auto=format&n=chU1iZMI9rskcnzW&q=85&s=bd7bcb4764e2362ca9305425fa042234" alt="Integrations" width="1600" height="988" data-path="concepts/img/integrations-2.png" />

Current available notification integrations include:

* Email (using instance SMTP server)

<Warning>
  Email Notification requires SMTP configuration at the instance level. If you
  don't see this integration available, please contact your Chainloop
  administrator to configure SMTP settings. For detailed instance configuration
  instructions, refer to the [SMTP configuration
  guide](/guides/deployment/platform#step-7-optional-setup-smtp-configuration).
</Warning>

* Microsoft Teams (webhooks).
  You can find information on how to create a Teams webhook URL in the
  [Microsoft Teams
  documentation](https://support.microsoft.com/en-us/office/create-incoming-webhooks-with-workflows-for-microsoft-teams-8ae491c7-0394-4861-ba59-055e33f75498).

* Slack webhooks. Check [Slack documentation](https://docs.slack.dev/messaging/sending-messages-using-incoming-webhooks/) to know how to configure them.

More channels will be added in future releases.

## Managing Notification Preferences

Users can manage notification preferences at different levels:

* **Organization notifications**: managed by Organization Oweners and Admins in the <i>Settings > Organization > Notifications</i> section.
  <img src="https://mintcdn.com/chainloop/5Tl2PSZfLTCZeFA-/concepts/img/integrations-9.png?fit=max&auto=format&n=5Tl2PSZfLTCZeFA-&q=85&s=5b8d7e75872e7cbd49735458f6ce4b5a" alt="Org notifications" width="1842" height="1183" data-path="concepts/img/integrations-9.png" />

* **Product notifications**: managed by Product Admins in the <i>Product Settings > Manage Notifications</i> section.
  <img src="https://mintcdn.com/chainloop/tlmo2649nuNWAVHf/concepts/img/notifications-product.png?fit=max&auto=format&n=tlmo2649nuNWAVHf&q=85&s=4e30f129816e5b34e4df81b7bbb54a24" alt="Product notifications" width="559" height="414" data-path="concepts/img/notifications-product.png" />

To enable notifications for a specific channel, just choose it in the drop-down list in the respective section:

<img src="https://mintcdn.com/chainloop/5Tl2PSZfLTCZeFA-/concepts/img/notifications-select.png?fit=max&auto=format&n=5Tl2PSZfLTCZeFA-&q=85&s=f4a4af8f9f73065d914e1653619d7355" alt="Select notification channel" width="534" height="600" data-path="concepts/img/notifications-select.png" />

To this date, these are the events that can trigger notifications:

| Event                     | Description                                                                        | Scope   | Available Channels                                       |
| ------------------------- | ---------------------------------------------------------------------------------- | ------- | -------------------------------------------------------- |
| Storage Backend Unhealthy | Triggered when the storage backend becomes unhealthy.                              | Org     | Email (to Org Admins and Owners), Microsoft Teams, Slack |
| Integration Unhealthy     | Triggered when one of the configured integrations becomes unhealthy.               | Org     | Email (to Org Admins and Owners), Microsoft Teams, Slack |
| Product Compliance Change | Triggered when there is a change in the aggregated compliance status of a Product. | Product | Email (to Product Admins), Microsoft Teams, Slack        |
| Product Release           | Triggered when a new release is made for a Product.                                | Product | Email (to Product Admins), Microsoft Teams, Slack        |