> ## Documentation Index
> Fetch the complete documentation index at: https://lightdash-refactor-full-audit-reorg.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Alerts

> Alerts enable you to receive notifications via email or Slack when the value of a saved chart meets your specified conditions.

At the scheduled time, Lightdash will run the query and check the results. If the first value in the results set meets the alerting condition, the alert will be sent. This notification will continue to be sent if the condition is true until it is manually disabled or deleted.

You can create or select an existing saved chart, add an alert to it, and tell Lightdash when you’d like the send out your update. You can set up as many alerts to a saved chart as you like, and if you make any changes to the content, Lightdash will update the alert the next time they’re sent. Alerts can be sent to an email address or into Slack (assuming your org has [added Slack](/integrations/slack)).

<Info>
  **For security reasons, the delivered files expire after 3 days.**

  This means old emails or Slack shares will have broken images and there is not an option to retrieve them. If you want to keep the sent files, it's best to download them from the alert.
</Info>

<Tip>
  **Self-hosted: fix broken images in emails behind firewalls**

  If your Lightdash instance is behind a firewall, email clients like Gmail may not be able to load images from your internal URLs. Set `EMAIL_SMTP_IMAGE_INLINE_CID=true` to embed images directly into emails as attachments. See [SMTP configuration](/self-host/customize-deployment/configure-smtp-for-lightdash-email-notifications) for details.
</Tip>

## Enabling alerts

Email alerts are available on all Lightdash Cloud plans.

To set up Slack, an organization admin will have to [add the Slack integration](/integrations/slack).

## Creating an alert

Only users with [admin, developer or edit access](/workspace-admin/roles) can create alerts. To create an alert, click on the three-dot menu in the top-right corner of your chart, then click on `Alerts`.

<Frame>
  <img src="https://mintcdn.com/lightdash-refactor-full-audit-reorg/-DvjDw66zBvkz4sP/images/explore/create-alerts/alert-three-dot-menu.png?fit=max&auto=format&n=-DvjDw66zBvkz4sP&q=85&s=fbd602cc6dedcb0604ebd487d0de92cb" width="2553" height="1375" data-path="images/explore/create-alerts/alert-three-dot-menu.png" />
</Frame>

You'll get a modal that pops up and shows you the list of existing alerts for your saved chart, and gives you the option to `Create new`.

<Frame>
  <img src="https://mintcdn.com/lightdash-refactor-full-audit-reorg/-DvjDw66zBvkz4sP/images/explore/create-alerts/alert-create-new-modal.png?fit=max&auto=format&n=-DvjDw66zBvkz4sP&q=85&s=01870f330f09b6f42031ca645b6c766b" width="1496" height="708" data-path="images/explore/create-alerts/alert-create-new-modal.png" />
</Frame>

Once you click on `Create new`, you'll be brought to a configuration screen for your new alert.

<Frame>
  <img src="https://mintcdn.com/lightdash-refactor-full-audit-reorg/-DvjDw66zBvkz4sP/images/explore/create-alerts/configure-alert.png?fit=max&auto=format&n=-DvjDw66zBvkz4sP&q=85&s=160d77b54f6b6f71b6fb62463cc9d2d5" width="1498" height="1440" data-path="images/explore/create-alerts/configure-alert.png" />
</Frame>

Here, you can configure your alert. The options are:

* **Alert name**: this is the name of your alert.
* **Conditions**: Configure the condition that is going to be evaluated against the first result(s).
  * `Alert field` The numeric field is going to be evaluated
  * `Condition`: Operator we are going to use to evaluate your value.
    * **is greater/less than**: Check if the `first` value in your results is greater/less than your threshold value.
    * **increased/decreased by**: Verify whether the percentage change in the first value relative to the second value exceeds the specified threshold, either by increasing or decreasing.
* **Run frequency**: This is the frequency at which Lightdash runs a query to check your data for changes. (You will be notified if the conditions on the latest value are met) . All times for the scheduler are in UTC.
* **Send to**: here, you can pick if you want to send your alert to Slack, email, or both. You can add as many Slack channels and email addresses as you'd like to here. You can send an alert to a person in Slack using `@persons-name` or to a channel using `#channel-name`.

## Editing and deleting your alerts

To edit an alert, click on the pencil-icon next to the alert you want to edit. This will bring you back to the configuration screen for your alert, where you can make any changes you'd like. In case you want to delete a alert, click on the trash-icon next to the alert you want to delete.

<Frame>
  <img src="https://mintcdn.com/lightdash-refactor-full-audit-reorg/-DvjDw66zBvkz4sP/images/explore/create-alerts/edit-delete-alert.png?fit=max&auto=format&n=-DvjDw66zBvkz4sP&q=85&s=9d16fe7d9b2b3357df4a699a31c7ab40" alt="" width="1489" height="706" data-path="images/explore/create-alerts/edit-delete-alert.png" />
</Frame>

You can also pause alerts by clicking the toggle button on the list of alerts.

## Sending to private Slack channels

<Info>
  You must add the Lightdash Slack bot to a private Slack channel before it can post there.
</Info>

To send to a private Slack channel, type the channel name exactly as it appears in Slack into the destination field, then click it to confirm.

## Sending to Microsoft Teams

You can send Lightdash deliveries directly to Microsoft Teams using incoming webhooks, keeping your team updated with key metrics right inside your Teams channels.

<Warning>
  The legacy Office 365 Connector webhooks are deprecated. Microsoft now recommends using **Power Automate Workflows** to create incoming webhooks for Teams.
</Warning>

### Creating a webhook with Power Automate Workflows

1. Go to [Power Automate](https://make.powerautomate.com/)
2. Select **Templates**
3. Filter by "webhook"
4. Select the **Post to a channel when a webhook request is received** template

<Frame>
  <img src="https://mintcdn.com/lightdash-refactor-full-audit-reorg/-DvjDw66zBvkz4sP/images/explore/create-scheduled-deliveries/msteams-select-template.png?fit=max&auto=format&n=-DvjDw66zBvkz4sP&q=85&s=c5831a1022d389244c333c7a954fc7e9" alt="" width="1556" height="637" data-path="images/explore/create-scheduled-deliveries/msteams-select-template.png" />
</Frame>

5. Select your Microsoft account and target Teams channel
6. Once added, click **Edit** on the workflow
7. Select the **When a Teams webhook request is received** trigger
8. Copy the **HTTP URL**

<Frame>
  <img src="https://mintcdn.com/lightdash-refactor-full-audit-reorg/-DvjDw66zBvkz4sP/images/explore/create-scheduled-deliveries/msteams-template-flow.png?fit=max&auto=format&n=-DvjDw66zBvkz4sP&q=85&s=2da2c636bd18a087672b95bc99630f29" alt="" width="1038" height="583" data-path="images/explore/create-scheduled-deliveries/msteams-template-flow.png" />
</Frame>

9. Use that HTTP URL in the webhook field in Lightdash

For more details, see the [official Microsoft documentation](https://support.microsoft.com/en-us/office/create-incoming-webhooks-with-workflows-for-microsoft-teams-8ae491c7-0394-4861-ba59-055e33f75498).

Add the webhook to the list of destinations in your delivery, then test how it looks in Teams by pressing **Send now**.
