Skip to content

docs: Document Drag To Dismiss option for notifications service #217

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
Louis047 wants to merge 1 commit into
base: main
Choose a base branch
from
+2 −0
Draft

docs: Document Drag To Dismiss option for notifications service #217

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions src/content/docs/v5/services/notifications.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,7 @@ offset_x = 20 # absolute horizontal margin from the scr
offset_y = 8 # absolute vertical margin from the screen edge
monitors = [] # empty = all monitors; otherwise connector/description selectors (e.g. ["eDP-1", "DP-1"])
collapse_on_dismiss = true # slide remaining toasts to close gaps when one is dismissed
enable_drag_to_dismiss = true # drag notification toasts toward screen edge to dismiss
history_retention_hours = 0 # delete stored history older than this; 0 keeps it indefinitely

[notification.filter.rhythmbox]
Expand All @@ -44,6 +45,7 @@ play_sound = true
- `history_retention_hours` removes stored external notifications older than the configured number of hours. The default
`0` retains history indefinitely; accepted values are `0`–`8760`.
- `collapse_on_dismiss = true` (default) causes remaining toasts to slide into a compact stack when one is dismissed. Set to `false` for stable-slot behavior where toasts keep their original positions.
- `enable_drag_to_dismiss = true` (default) allows mouse cursor dragging of notification toasts toward the nearest screen edge to dismiss them. Configure in **Settings → Notifications → Toasts → Drag to Dismiss**.
- `border = true` (default) draws an outline around toast cards. Set to `false` for a borderless look.
- `history_retention_hours = 0` (default) keeps notification history entries forever. Set to a positive integer (1–8760) to automatically remove entries older than that many hours from control-center history. Active on-screen toasts are never removed. Configure in **Settings → Notifications → History**.

Expand Down