diff --git a/ai/slack-app.mdx b/ai/slack-app.mdx
index 13215e99d..ab611cd22 100644
--- a/ai/slack-app.mdx
+++ b/ai/slack-app.mdx
@@ -1,16 +1,18 @@
---
title: "Slack app"
-description: "Add a bot that searches your docs to answers questions in your Slack workspace."
-keywords: ["Slack bot", "workspace", "questions"]
+description: "Add a bot to your Slack workspace that answers questions based on your documentation."
+keywords: ["bot", "workspace", "Q&A", "Slack"]
---
- The Slack app is available for [Pro and Custom plans](https://mintlify.com/pricing?ref=slack-app).
+ The Slack app is available for [Pro and Custom plans](https://mintlify.com/pricing?ref=slack-app) with access to the assistant.
-The Slack app adds a bot to your Slack workspace that can search your documentation and answer users' questions. The bot responds to direct messages, @mentions, and to any questions in a channel specifically named `#ask-ai`. The bot's name is `@yourprojectname-assistant`. So if your project name is Mintlify, the bot's name is `@mintlify-assistant`.
+The Slack app adds a bot to your workspace that supports your community with real-time answers. The bot uses the Mintlify assistant to search your docs and provide accurate, cited responses, so it is always up-to-date.
-The Slack app can incur costs: either using your AI assistant credits or incurring overages.
+The bot responds to `@` mentions and to every message in channels named `#ask-ai`.
+
+Each message sent by the bot counts toward your assistant message usage.
## Set up the Slack app
@@ -18,10 +20,26 @@ The Slack app can incur costs: either using your AI assistant credits or incurri
If your Slack Workspace Owner requires admin approval to install apps, ask them to approve the Mintlify Slack app before you add it.
-1. Navigate to the [Add-ons](https://dashboard.mintlify.com/products/addons) page of your dashboard.
-2. Select **Connect** in the Slack Integration card.
-3. Follow the Slack prompts to add the app to your workspace.
-4. Test that the bot is working and responds when you:
- - Send a direct message to the bot.
- - Mention the bot in a channel.
- - Create an `#ask-ai` channel, add the bot, and ask a question.
+1. Navigate to the [Integrations](https://dashboard.mintlify.com/products/assistant/settings/integrations) tab of the **Assistant Configurations** page in your dashboard.
+1. In the Slack card, click **Connect**. This opens Slack.
+
+ 
+ 
+
+1. Follow the Slack prompts to add the app to your workspace.
+1. Mention the bot to add it to a channel. The bot's default name is TODO:
+
+### Customize the bot's name
+
+1. In Slack, select the Mintlify app in the **Apps** menu.
+1. Click **About**.
+1. Click **Configuration**. This opens the app configuration page in a web browser.
+1. In the **Bot User** section, edit the bot name.
+
+## Create an `#ask-ai` channel
+
+To help your users quickly get answers to their questions, create a channel named `#ask-ai`. The bot will respond to every message in that channel. See [Create a channel](https://slack.com/help/articles/201402297-Create-a-channel) in the Slack Help Center for more information.
+
+## Manage the Slack app
+
+After you add the app to your workspace, you can manage or remove the app from the [Integrations](https://dashboard.mintlify.com/products/assistant/settings/integrations) tab.
diff --git a/docs.json b/docs.json
index 2f4d0288a..46dd042cf 100644
--- a/docs.json
+++ b/docs.json
@@ -162,6 +162,7 @@
"insights/feedback"
]
},
+ "ai/slack-app",
"ai/llmstxt",
"ai/model-context-protocol",
"optimize/seo",
diff --git a/images/assistant/slack-connect-dark.png b/images/assistant/slack-connect-dark.png
new file mode 100644
index 000000000..e7c6ff091
Binary files /dev/null and b/images/assistant/slack-connect-dark.png differ
diff --git a/images/assistant/slack-connect-light.png b/images/assistant/slack-connect-light.png
new file mode 100644
index 000000000..e634af3d6
Binary files /dev/null and b/images/assistant/slack-connect-light.png differ