diff --git a/ai/suggestions.mdx b/ai/suggestions.mdx
index 7b7da3d4c..94691312c 100644
--- a/ai/suggestions.mdx
+++ b/ai/suggestions.mdx
@@ -81,3 +81,27 @@ If a suggestion doesn't require documentation updates or you've already addresse
 1. Click the **Dismiss** button next any suggestions that you want to dismiss.
 
 The suggestion is immediately removed from your dashboard. You cannot retrieve dismissed suggestions.
+
+## Notifications
+
+Receive notifications when the agent creates new suggestions. You can configure email and Slack notifications to stay informed about documentation updates without checking the dashboard.
+
+### Configure notification preferences
+
+Configure your notification preferences in the agent settings.
+
+1. Click the **Ask agent** button in your dashboard to open the agent panel.
+1. Click the **Settings** button.
+1. In the notification settings, select your preferred frequency for email and Slack notifications.
+
+Set the frequency to **per-merge** to receive a notification each time the agent creates a suggestion from a merged pull request. This ensures you're immediately notified when new documentation updates are needed.
+
+### Email notifications
+
+When email notifications are enabled with the per-merge frequency, you receive an email each time the agent creates a suggestion. The email includes the suggestion title, the pull request that triggered it, and a link to review the suggested changes in your dashboard.
+
+### Slack notifications
+
+When Slack notifications are enabled with the per-merge frequency, you receive a Slack message each time the agent creates a suggestion. To receive Slack notifications, you must connect your Slack account to Mintlify.
+
+The Slack notification includes the suggestion details and a link to your dashboard where you can review and act on the suggestion.