From 20187a2efe3ad9ecc0b076bfa4fdf97c75bf0fde Mon Sep 17 00:00:00 2001 From: Matthew Helmke Date: Mon, 11 May 2026 14:50:08 -0500 Subject: [PATCH 1/3] add notifications troubleshooting FAQ --- .../use-chainguard-notifications/index.md | 34 +++++++++++++++++++ 1 file changed, 34 insertions(+) diff --git a/content/chainguard/chainguard-images/how-to-use/use-chainguard-notifications/index.md b/content/chainguard/chainguard-images/how-to-use/use-chainguard-notifications/index.md index 333cc3d09c..e9a45fe096 100644 --- a/content/chainguard/chainguard-images/how-to-use/use-chainguard-notifications/index.md +++ b/content/chainguard/chainguard-images/how-to-use/use-chainguard-notifications/index.md @@ -104,3 +104,37 @@ Notifications fall into one of multiple categories based on content. Here's a li - **Product lifecycle** - Has two sub-categories: - **End of life** - **New releases** + +## Troubleshooting FAQ + +**Q:** I connected Slack successfully, but the channel I want to use doesn't appear in the "Slack Channels" dropdown. Other channels show up fine — why is this one missing? + +The most common cause is that the channel is private. The Chainguard Notifications Slack app can only see public channels by default. To make a private channel selectable: + +1. In Slack, open the private channel. +1. Click the channel members icon, then open the **Integrations** tab. +1. Click **Add an App**, find **Chainguard Notifications**, and click **Add**. +1. Return to the Chainguard Console and refresh the **Settings > Activity Center** page. The private channel should now appear in the dropdown. + +**Q:** My channel is public, I'm a member of it, and I even added the Chainguard Notifications app to it — but it still doesn't show up. What's wrong? + +This usually means the email address you used to sign in to the Chainguard Console doesn't match the email address associated with your account in your company's Slack workspace. + +The Slack app uses your Console email to look up your Slack user ID — if it can't find a matching user in your workspace, it can't determine which channels you have access to, and the channel list comes back empty (or partial). + +A common version of this scenario is signing in to the Console with your Github profile linked to your personal Gmail (e.g. you@gmail.com) while your corporate Slack workspace knows you as you@company.com. + +To fix it: + +1. In the Console, disconnect the Slack integration in **Settings > Activity Center > Integrations > Edit**. +1. Sign out of the Chainguard Console. +1. Sign back in using the email address that matches your corporate Slack workspace identity. +1. Re-connect Slack and complete the OAuth flow again. + +**Q:** I disconnected and reconnected Slack with the correct email, but the channel I want still isn't appearing. Now what? + +After reconnecting, the channel list can get stuck on a stale cached version from the previous session. + +A hard refresh of the Console tab almost always resolves it. On Mac use `Cmd + Shift + R` or on Windows and Linux use `Ctrl + Shift + R` to refresh. + +Then reopen **Settings > Activity Center** and check the channel dropdown again. If the channel still doesn't appear after a hard refresh, contact your Chainguard Customer Success representative — they can verify on the backend that your Slack user ID was successfully linked to the Notifications service. From 14b0bbb741bd0d90239ae531290d66c764dfce4e Mon Sep 17 00:00:00 2001 From: Matthew Helmke Date: Mon, 11 May 2026 15:09:19 -0500 Subject: [PATCH 2/3] add headings for questions to enhance findability --- .../how-to-use/use-chainguard-notifications/index.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/content/chainguard/chainguard-images/how-to-use/use-chainguard-notifications/index.md b/content/chainguard/chainguard-images/how-to-use/use-chainguard-notifications/index.md index e9a45fe096..d0d485031b 100644 --- a/content/chainguard/chainguard-images/how-to-use/use-chainguard-notifications/index.md +++ b/content/chainguard/chainguard-images/how-to-use/use-chainguard-notifications/index.md @@ -105,7 +105,9 @@ Notifications fall into one of multiple categories based on content. Here's a li - **End of life** - **New releases** -## Troubleshooting FAQ +## Troubleshooting FAQ - setting up Slack + +### Channel seems to be missing **Q:** I connected Slack successfully, but the channel I want to use doesn't appear in the "Slack Channels" dropdown. Other channels show up fine — why is this one missing? @@ -116,6 +118,8 @@ The most common cause is that the channel is private. The Chainguard Notificatio 1. Click **Add an App**, find **Chainguard Notifications**, and click **Add**. 1. Return to the Chainguard Console and refresh the **Settings > Activity Center** page. The private channel should now appear in the dropdown. +### Channel still seems to be missing + **Q:** My channel is public, I'm a member of it, and I even added the Chainguard Notifications app to it — but it still doesn't show up. What's wrong? This usually means the email address you used to sign in to the Chainguard Console doesn't match the email address associated with your account in your company's Slack workspace. @@ -131,6 +135,8 @@ To fix it: 1. Sign back in using the email address that matches your corporate Slack workspace identity. 1. Re-connect Slack and complete the OAuth flow again. +### I still cannot find the channel + **Q:** I disconnected and reconnected Slack with the correct email, but the channel I want still isn't appearing. Now what? After reconnecting, the channel list can get stuck on a stale cached version from the previous session. From 571e6d0d4db893658103b71e83b30a4394552e86 Mon Sep 17 00:00:00 2001 From: Matthew Helmke Date: Mon, 11 May 2026 15:13:03 -0500 Subject: [PATCH 3/3] change to better headings --- .../how-to-use/use-chainguard-notifications/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/chainguard/chainguard-images/how-to-use/use-chainguard-notifications/index.md b/content/chainguard/chainguard-images/how-to-use/use-chainguard-notifications/index.md index d0d485031b..f38745f426 100644 --- a/content/chainguard/chainguard-images/how-to-use/use-chainguard-notifications/index.md +++ b/content/chainguard/chainguard-images/how-to-use/use-chainguard-notifications/index.md @@ -107,7 +107,7 @@ Notifications fall into one of multiple categories based on content. Here's a li ## Troubleshooting FAQ - setting up Slack -### Channel seems to be missing +### Channel seems to be missing — check if it is private **Q:** I connected Slack successfully, but the channel I want to use doesn't appear in the "Slack Channels" dropdown. Other channels show up fine — why is this one missing? @@ -118,7 +118,7 @@ The most common cause is that the channel is private. The Chainguard Notificatio 1. Click **Add an App**, find **Chainguard Notifications**, and click **Add**. 1. Return to the Chainguard Console and refresh the **Settings > Activity Center** page. The private channel should now appear in the dropdown. -### Channel still seems to be missing +### Channel still seems to be missing — check which email address you are using **Q:** My channel is public, I'm a member of it, and I even added the Chainguard Notifications app to it — but it still doesn't show up. What's wrong? @@ -135,7 +135,7 @@ To fix it: 1. Sign back in using the email address that matches your corporate Slack workspace identity. 1. Re-connect Slack and complete the OAuth flow again. -### I still cannot find the channel +### I still cannot find the channel — refresh the Console cache **Q:** I disconnected and reconnected Slack with the correct email, but the channel I want still isn't appearing. Now what?