Skip to content

[Notifications] DashButton component #24941

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Sep 4, 2025
Merged

[Notifications] DashButton component #24941

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 14 additions & 13 deletions src/content/docs/bots/reference/alerts.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ sidebar:

---

import { AvailableNotifications, Steps } from "~/components"
import { AvailableNotifications, Steps, DashButton } from "~/components"

Bot alerts inform you when Cloudflare detects spikes in your traffic with any of the following characteristics:

Expand All @@ -25,18 +25,19 @@ Bot alerts inform you when Cloudflare detects spikes in your traffic with any of
To receive Bot alerts, you must [configure a notification](/notifications/get-started/). Notifications help you stay up to date with your Cloudflare account through email, PagerDuty, or webhooks, depending on your Cloudflare plan.

<Steps>
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/), and select your account.
2. Go to **Notifications**.
3. In **Notifications**, select **Add**.
4. Select **Bot Management** from the Product list.
5. Choose one of the available bot detection alerts (depending on whether you want to set up custom filters and/or grouping):
- Bot Detection Alert
- Custom Bot Detection Alert
6. Enter a notification name and (optionally) a description.
7. Select the domain(s) to monitor for this alert.
8. Configure a delivery method for the notification. The available delivery methods depend on your Cloudflare plan. For more information, refer to [Cloudflare Notifications](/notifications/).
9. If you are creating a notification for Custom Bot Detection Alert, define the parameters that will filter the notifications you will receive.
10. Select **Save**.
1. In the Cloudflare dashboard, go to the **Notifications** page.

<DashButton url="/?to=/:account/notifications" />
3. Select **Add**.
4. Select **Bot Management** from the Product list.
5. Choose one of the available bot detection alerts (depending on whether you want to set up custom filters and/or grouping):
- Bot Detection Alert
- Custom Bot Detection Alert
6. Enter a notification name and (optionally) a description.
7. Select the domain(s) to monitor for this alert.
8. Configure a delivery method for the notification. The available delivery methods depend on your Cloudflare plan. For more information, refer to [Cloudflare Notifications](/notifications/).
9. If you are creating a notification for Custom Bot Detection Alert, define the parameters that will filter the notifications you will receive.
10. Select **Save**.
</Steps>

---
Expand Down
14 changes: 10 additions & 4 deletions src/content/docs/notifications/get-started/configure-pagerduty.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@ sidebar:

---

import { DashButton } from "~/components";

:::note

This feature is only available if your account has at least one zone on a Business or higher plan. For more information, refer to our [plans](https://www.cloudflare.com/plans/).
Expand All @@ -24,8 +26,10 @@ According to PagerDuty, you will need an account with the following permissions

## Connect PagerDuty to a Cloudflare account

1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login) and select your account.
2. Go to **Notifications** > **Destinations**.
1. In the Cloudflare dashboard, go to the **Notifications** page.

<DashButton url="/?to=/:account/notifications" />
2. Go to **Destinations**.
3. In the **Connected notification services** card, select **Connect**.
4. Log in to your [PagerDuty account](https://www.pagerduty.com/) to connect it to your Cloudflare account.
5. Choose the services you want to use and select **Connect**.
Expand All @@ -41,8 +45,10 @@ Disconnecting PagerDuty will disable any notifications being sent to PagerDuty w

If other delivery destinations were selected, then those notifications will still be routed as configured.

1. Log in to your [Cloudflare dashboard](https://dash.cloudflare.com/login) and select your account.
2. Go to **Notifications** > **Destinations**.
1. In the Cloudflare dashboard, go to the **Notifications** page.

<DashButton url="/?to=/:account/notifications" />
2. Go to **Destinations**.
3. In the **Connected notification services** card, select **View** on the PagerDuty service you want to disconnect.
4. Select **Disconnect** > **Confirm**.
5. Log in to your [PagerDuty account](https://www.pagerduty.com/) and make the required changes.
Expand Down
14 changes: 10 additions & 4 deletions src/content/docs/notifications/get-started/configure-webhooks.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@ sidebar:

---

import { DashButton } from "~/components";

:::note

This feature is only available if your account has at least one zone with a pro plan or above. For more information, refer to our [plans](https://www.cloudflare.com/plans/).
Expand All @@ -15,8 +17,10 @@ There are a variety of services you can connect to Cloudflare using webhooks to

## Configure webhooks

1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login) and select your account.
2. Go to **Notifications** > **Destinations**.
1. In the Cloudflare dashboard, go to the **Notifications** page.

<DashButton url="/?to=/:account/notifications" />
2. Go to **Destinations**.
3. In the **Webhooks** card, select **Create**.
4. Give your webhook a name to use for identification later.
5. In the **URL** field, enter the URL of the third-party service that you have previously set up and want to connect to your Cloudflare account.
Expand All @@ -29,8 +33,10 @@ The new webhook will appear in the **Webhooks** card.

You can only edit the name of webhooks and/or delete them.

1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login) and select your account.
2. Go to **Notifications** > **Destinations**.
1. In the Cloudflare dashboard, go to the **Notifications** page.

<DashButton url="/?to=/:account/notifications" />
2. Go to **Destinations**.
3. In the **Webhooks** card, select **Edit** on the webhook that you want to edit.
4. Update the webhook's name and select **Save**.

Expand Down
31 changes: 18 additions & 13 deletions src/content/docs/notifications/get-started/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,8 @@ sidebar:

---

import { DashButton } from "~/components";

The list of notifications available depends on the type of account you have. Refer to [Available Notifications](/notifications/notification-available/) to learn more about what each notification does and what do to when receiving one.

You can check the [Notification History](/notifications/notification-history/) using the API to view notifications that have been generated for your account.
Expand All @@ -31,12 +33,13 @@ This guide will help you create, edit, test, or delete notifications using the C

You can create a notification via the Cloudflare dashboard.

1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login) and select your account.
2. Go to **Notifications**.
3. Select **Add**.
4. On the notification you want to create, choose **Select**.
5. Name the notification.
6. Enter an email address to receive the notifications.
1. In the Cloudflare dashboard, go to the **Notifications** page.

<DashButton url="/?to=/:account/notifications" />
2. Select **Add**.
3. On the notification you want to create, choose **Select**.
4. Name the notification.
5. Enter an email address to receive the notifications.

:::note

Expand All @@ -52,20 +55,22 @@ The browser will navigate back to the list of notifications, where the new notif

You can edit existing Notifications via the Cloudflare dashboard.

1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login) and select your account.
2. Go to **Notifications**.
3. Select **Edit** on the Notification that you want to modify.
4. Make your changes as needed and select **Save**.
1. In the Cloudflare dashboard, go to the **Notifications** page.

<DashButton url="/?to=/:account/notifications" />
2. On the notification that you want to modify, select **Edit**.
3. Make your changes as needed and select **Save**.

The browser will navigate back to the list of notifications.

### Disable or delete a notification

You can delete or disable existing Notifications via the Cloudflare dashboard.

1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login) and select your account.
2. Go to **Notifications**.
3. On the notification that you want to disable, select the **Enabled** toggle. To delete it, select **Delete**.
1. In the Cloudflare dashboard, go to the **Notifications** page.

<DashButton url="/?to=/:account/notifications" />
2. On the notification that you want to disable, select the **Enabled** toggle. To delete it, select **Delete**.

### Test a notification

Expand Down