diff --git a/workflows/enable.mdx b/workflows/enable.mdx
index a465adc8c..d0c402650 100644
--- a/workflows/enable.mdx
+++ b/workflows/enable.mdx
@@ -74,6 +74,35 @@ You can change the target languages at any time by opening the workflow's settin
 
 After saving the workflow, click **Translate now** to run it on demand using the currently saved target languages. The workflow must be enabled to trigger a manual run. Manual runs do not affect the workflow's regular trigger.
 
+## Workflow notifications in Slack
+
+Connect Slack to receive notifications when a workflow runs, completes, or needs your attention. Use this when you want updates to land directly in a channel instead of checking the dashboard.
+
+Slack notifications are configured per project. Each project picks which Slack workspace to install into and which channels receive notifications.
+
+<Note>
+  Notifications use a dedicated Slack app for workflow events. Installing it is separate from connecting the [Mintlify agent to Slack](/agent/slack).
+</Note>
+
+### Connect Slack
+
+1. Open the [Workflows](https://dashboard.mintlify.com/products/workflows?tab=workflows) page in your dashboard.
+2. Start the workflows onboarding flow and continue to the **Workflow notifications** step, or open notification settings from an existing workflow.
+3. Click **Connect slack**, then follow the Slack prompts to install the Mintlify notifications app and grant the requested permissions.
+4. After Slack confirms the install, the channel picker opens automatically so you can select where notifications are delivered.
+
+### Select notification channels
+
+1. In the channel picker, search for the channels you want to receive workflow notifications.
+2. Select one or more channels, then click **Save**.
+3. To change channels later, click **Configure** beside the connected Slack workspace.
+
+Mintlify posts a notification to every selected channel when a workflow run starts, finishes, or fails.
+
+### Skip notifications setup
+
+You can skip Slack setup during onboarding and connect it later from the workflow configuration. Workflows still run on their normal triggers without notifications.
+
 ## Improve docs from assistant chats
 
 The **Improve docs from assistant chats** workflow reviews recent trends in [assistant](/assistant/index) questions and opens targeted documentation updates that address gaps your users hit.