From 8053c45e97d82506d1c0ad0521f0395e9f0df19c Mon Sep 17 00:00:00 2001
From: 7w1 <noreply@sl.sable.moe>
Date: Tue, 10 Mar 2026 11:15:20 -0500
Subject: [PATCH 1/2] clarify notification settings

---
 .changeset/clarify_notification_settings.md   |  5 ++
 .../components/unread-badge/UnreadBadge.tsx   | 10 +++-
 .../notifications/SystemNotification.tsx      | 52 ++++++++++++-------
 3 files changed, 45 insertions(+), 22 deletions(-)
 create mode 100644 .changeset/clarify_notification_settings.md

diff --git a/.changeset/clarify_notification_settings.md b/.changeset/clarify_notification_settings.md
new file mode 100644
index 000000000..5023bfd42
--- /dev/null
+++ b/.changeset/clarify_notification_settings.md
@@ -0,0 +1,5 @@
+---
+sable: patch
+---
+
+Clarify notification settings and functionality once and for all.
diff --git a/src/app/components/unread-badge/UnreadBadge.tsx b/src/app/components/unread-badge/UnreadBadge.tsx
index 4648ae053..1ad2605ab 100644
--- a/src/app/components/unread-badge/UnreadBadge.tsx
+++ b/src/app/components/unread-badge/UnreadBadge.tsx
@@ -26,9 +26,15 @@ export function UnreadBadge({ highlight, count, dm }: UnreadBadgeProps) {
   const [badgeCountDMsOnly] = useSetting(settingsAtom, 'badgeCountDMsOnly');
   const [showPingCounts] = useSetting(settingsAtom, 'showPingCounts');
 
-  // Show count when: (showUnreadCounts OR highlight+showPingCounts) AND (not DM-only mode OR this is a DM)
+  /**
+   * Show a number if there is a count and:
+   * - Its a dm and dm counts are enabled
+   * - Its a normal room and unread counts are enabled
+   * - Its a ping and ping counts are enabled
+   */
   const showNumber =
-    count > 0 && (showUnreadCounts || (highlight && showPingCounts)) && (!badgeCountDMsOnly || dm);
+    count > 0 &&
+    ((dm && badgeCountDMsOnly) || (!dm && showUnreadCounts) || (highlight && showPingCounts));
 
   return (
     <Badge
diff --git a/src/app/features/settings/notifications/SystemNotification.tsx b/src/app/features/settings/notifications/SystemNotification.tsx
index 3a3d47974..87ab5fc09 100644
--- a/src/app/features/settings/notifications/SystemNotification.tsx
+++ b/src/app/features/settings/notifications/SystemNotification.tsx
@@ -192,16 +192,33 @@ export function SystemNotification() {
 
   // Describe what the current badge combo actually does so users aren't left guessing.
   const badgeBehaviourSummary = (): string => {
-    if (!showUnreadCounts && !showPingCounts) {
-      return 'Badges show a plain dot for any unread activity — no numbers displayed.';
-    }
-    if (!showUnreadCounts && showPingCounts) {
-      return 'Badges show a number only when you are directly mentioned; all other unread activity shows a plain dot.';
+    const showDMs = badgeCountDMsOnly;
+    const showRooms = showUnreadCounts;
+    const showPings = showPingCounts;
+
+    if (showDMs && showRooms && showPings) {
+      return 'All unread messages—DMs, Rooms, and mentions—show a number count.';
     }
-    if (showUnreadCounts && badgeCountDMsOnly) {
-      return 'Only Direct Message badges show a number count. Rooms and spaces show a plain dot instead.';
+    if (!showDMs && !showRooms && !showPings) {
+      return 'Badges show a plain dot for all unread activity—no numbers displayed.';
     }
-    return 'All rooms and DMs show a number count for every unread message.';
+
+    if (showDMs && !showRooms && !showPings)
+      return 'Only Direct Messages show a number count. Rooms and mentions show a plain dot.';
+    if (!showDMs && showRooms && !showPings)
+      return 'Only Rooms and spaces show a number count. DMs and mentions show a plain dot.';
+    if (!showDMs && !showRooms && showPings)
+      return 'Only mentions and keywords show a number count. All other activity shows a plain dot.';
+
+    // Case 4: Exactly two are ON
+    if (showDMs && showRooms && !showPings)
+      return 'DMs and Rooms show a number count. Mentions show a plain dot.';
+    if (showDMs && !showRooms && showPings)
+      return 'DMs and mentions show a number count. Rooms and spaces show a plain dot.';
+    if (!showDMs && showRooms && showPings)
+      return 'Rooms and mentions show a number count. Direct Messages show a plain dot.';
+
+    return ''; // Fallback
   };
 
   return (
@@ -328,8 +345,8 @@ export function SystemNotification() {
         gap="400"
       >
         <SettingTile
-          title="Show Message Counts"
-          description="Show a number on room, space, and DM badges for every unread message."
+          title="Show Room Counts"
+          description="Displays a number for unread activity in Rooms and Spaces."
           after={
             <Switch variant="Primary" value={showUnreadCounts} onChange={setShowUnreadCounts} />
           }
@@ -342,15 +359,10 @@ export function SystemNotification() {
         gap="400"
       >
         <SettingTile
-          title="Direct Messages Only"
-          description="Only DM badges display a count. Room and space badges show a plain dot instead."
+          title="Show DM Counts"
+          description="Displays a number for unread Direct Messages."
           after={
-            <Switch
-              variant="Primary"
-              value={badgeCountDMsOnly}
-              onChange={setBadgeCountDMsOnly}
-              disabled={!showUnreadCounts}
-            />
+            <Switch variant="Primary" value={badgeCountDMsOnly} onChange={setBadgeCountDMsOnly} />
           }
         />
       </SequenceCard>
@@ -361,8 +373,8 @@ export function SystemNotification() {
         gap="400"
       >
         <SettingTile
-          title="Always Count Mentions"
-          description="Show a number on any badge where you were directly mentioned, even if message counts are turned off."
+          title="Show Mention Counts"
+          description="Displays a number for mentions and keyword alerts."
           after={<Switch variant="Primary" value={showPingCounts} onChange={setShowPingCounts} />}
         />
       </SequenceCard>

From e124ac195776d4ea27dbbc900e753857d468ecf7 Mon Sep 17 00:00:00 2001
From: 7w1 <noreply@sl.sable.moe>
Date: Tue, 10 Mar 2026 11:23:37 -0500
Subject: [PATCH 2/2] default settings adjustment

---
 src/app/state/settings.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/app/state/settings.ts b/src/app/state/settings.ts
index 29bea6897..ab4d6ef18 100644
--- a/src/app/state/settings.ts
+++ b/src/app/state/settings.ts
@@ -160,7 +160,7 @@ const defaultSettings: Settings = {
   hideMembershipInReadOnly: true,
   useRightBubbles: false,
   showUnreadCounts: false,
-  badgeCountDMsOnly: false,
+  badgeCountDMsOnly: true,
   showPingCounts: true,
   hideReads: false,
   emojiSuggestThreshold: 2,