From a367e0383bfdece2872415d2c1422597fc6aaaa5 Mon Sep 17 00:00:00 2001
From: cdxker <32852291+cdxker@users.noreply.github.com>
Date: Wed, 17 Dec 2025 16:20:07 -0800
Subject: [PATCH] Update ai/suggestions.mdx

Co-Authored-By: mintlify-development[bot] <109878554+mintlify-development[bot]@users.noreply.github.com>
---
 ai/suggestions.mdx | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

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.