> ## Documentation Index
> Fetch the complete documentation index at: https://docs.junojourney.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Notification Issues

> Not receiving notifications? Here's how notifications work in Juno and what to check.

export const FeatureAvailability = ({module, feature}) => {
  const label = feature || module;
  return <Info title="Feature availability">
      {label ? <>This feature requires the <strong>{label}</strong> module. </> : <>This feature may not be enabled for your organization. </>}
      If you don't see it in Juno, contact your administrator.
    </Info>;
};

export const InternalNote = ({children}) => {
  const [isInternal, setIsInternal] = useState(false);
  useEffect(() => {
    const user = window.__mintlify_user__;
    if (user?.groups?.includes("internal")) setIsInternal(true);
  }, []);
  if (!isInternal) return null;
  return <div className="internal-note">
      <strong className="internal-note-title">🔒 Internal Note</strong>
      <div>{children}</div>
    </div>;
};

## How notifications work

Juno can send notifications through multiple channels. Which channels are active depends on your organization's configuration:

| Channel             | How it reaches you                                |
| ------------------- | ------------------------------------------------- |
| **Email**           | Your registered work email                        |
| **In-app**          | Bell icon (top-right) inside Juno                 |
| **Push**            | Browser or mobile push notifications              |
| **SMS**             | Text message to your registered phone number      |
| **WhatsApp**        | Message to your registered phone number           |
| **Slack**           | Direct message via your connected Slack workspace |
| **Microsoft Teams** | Message via your connected Teams account          |

Not all channels are available in every organization — your admin chooses which ones to enable.

***

## I'm not getting email notifications

1. **Check spam/junk**: Juno emails may land in your spam folder, especially the first time
2. **Verify your email**: Make sure the email in your Juno profile is correct and you have access to that inbox
3. **Check your preferences**: Click your avatar → **Settings** → **Notifications**. Make sure the relevant notification category isn't disabled.
4. **Ask your admin**: Your organization may have disabled certain email notification types

You can disable notifications by category:

* Training reminders
* Group updates
* Recommendations
* Assigned by team
* Course recommendations
* Request reminders
* Manager digest (if enabled by your org)

<InternalNote>
  If a user reports missing emails: (1) Check `UserNotificationsPref` collection for `unsubscribed: true` or specific disabled categories in `disabledEmails`. (2) Check `TenantEmailConfig` for the org — `disabled: true` means all emails are off, `blackList` may block specific notification types. (3) Check `NotificationsQueue` collection — find the notification by user ID, check `isHandled`, `sentPlatforms.Email.sentSuccessfully`, and `sentPlatforms.Email.errorReason`. (4) Check SendGrid delivery logs for bounces, blocks, or spam reports. There is no automatic retry — failed notifications are logged with error reason but not re-sent.
</InternalNote>

***

## I'm not getting push notifications

1. **Allow browser notifications**: Your browser must have notification permissions enabled for your Juno domain
2. **Check Juno settings**: Avatar → Settings → Notifications → make sure push notifications are not disabled
3. **Browser support**: Push works best in Chrome and Edge. Safari has limited push support.

<InternalNote>
  Push uses Firebase Cloud Messaging (FCM). Check the user's `UserNotificationsPref` for `desktopPushDisabled` or `mobilePushDisabled`. Also check if `gcmToken.web` or `gcmToken.mobile` exists — if there's no token, the user never granted browser notification permission.
</InternalNote>

***

## Due date reminders

Juno sends a due date reminder **2 days before** an assignment's due date. This notification is sent via your organization's active channels (email, push, etc.).

If you didn't receive a due date reminder:

* Confirm the assignment actually has a due date set (visible on the assignment card)
* Check that you haven't disabled "Training reminders" in your notification settings
* The reminder may have gone to a different channel (e.g. in-app instead of email)

***

## Slack or Teams notifications not working

If your organization uses Slack or Microsoft Teams integration:

1. **Confirm the integration is connected**: Ask your admin if Slack/Teams notifications are enabled for your org
2. **Check your account**: Your Juno account must be linked to the correct Slack/Teams identity
3. **Workspace access**: You must be a member of the connected Slack workspace or Teams tenant

<InternalNote>
  Slack: check `TenantEmailConfig.slackConfig.enabled` and `slackConfig.accessToken`. Teams: check `TenantEmailConfig.messagingApp === "teams"`. The tenant's `messagingApp` field determines whether Slack or Teams is the active messaging channel — only one can be active at a time. Check `sentPlatforms.Slack` or `sentPlatforms.Teams` in `NotificationsQueue` for delivery errors.
</InternalNote>

***

## Too many notifications

If you're receiving too many notifications:

1. Go to avatar → **Settings** → **Notifications**
2. Disable the categories you don't want (e.g. recommendations, group updates)
3. You can also disable push notifications specifically while keeping email

To stop all notifications, toggle the global unsubscribe — but note this disables everything including assignment reminders.
