Merge pull request #6566 from MicrosoftDocs/drewbat/app-notifications-wasdk-migration-v2

Update app notifications docs: prioritize WinAppSDK, remove Community Toolkit

Author: drewbatgit

.openpublishing.redirection.json

@@ -9587,12 +9587,12 @@
     },
     {
       "source_path": "hub/apps/design/shell/tiles-and-notifications/custom-audio-on-toasts.md",
-      "redirect_url": "../../../develop/notifications/app-notifications/custom-audio-on-toasts",
+      "redirect_url": "../../../develop/notifications/app-notifications/app-notifications-custom-audio",
       "redirect_document_id": false
     },
     {
       "source_path": "hub/apps/design/shell/tiles-and-notifications/custom-timestamps-on-toasts.md",
-      "redirect_url": "../../../develop/notifications/app-notifications/custom-timestamps-on-toasts",
+      "redirect_url": "../../../develop/notifications/app-notifications/app-notifications-custom-timestamps",
       "redirect_document_id": false
     },
     {
@@ -9612,7 +9612,7 @@
     },
     {
       "source_path": "hub/apps/design/shell/tiles-and-notifications/scheduled-toast.md",
-      "redirect_url": "../../../develop/notifications/app-notifications/scheduled-toast",
+      "redirect_url": "../../../develop/notifications/app-notifications/app-notifications-scheduled",
       "redirect_document_id": false
     },
     {
@@ -9637,7 +9637,7 @@
     },
     {
       "source_path": "hub/apps/design/shell/tiles-and-notifications/toast-collections.md",
-      "redirect_url": "../../../develop/notifications/app-notifications/toast-collections",
+      "redirect_url": "../../../develop/notifications/app-notifications/app-notifications-collections",
       "redirect_document_id": false
     },
     {
@@ -9647,7 +9647,7 @@
     },
     {
       "source_path": "hub/apps/design/shell/tiles-and-notifications/toast-headers.md",
-      "redirect_url": "../../../develop/notifications/app-notifications/toast-headers",
+      "redirect_url": "../../../develop/notifications/app-notifications/app-notifications-headers",
       "redirect_document_id": false
     },
     {
@@ -9657,22 +9657,142 @@
     },
     {
       "source_path": "hub/apps/design/shell/tiles-and-notifications/toast-pending-update.md",
-      "redirect_url": "../../../develop/notifications/app-notifications/toast-pending-update",
+      "redirect_url": "../../../develop/notifications/app-notifications/app-notifications-pending-update",
       "redirect_document_id": false
     },
     {
       "source_path": "hub/apps/design/shell/tiles-and-notifications/toast-progress-bar.md",
-      "redirect_url": "../../../develop/notifications/app-notifications/toast-progress-bar",
+      "redirect_url": "../../../develop/notifications/app-notifications/app-notifications-progress-bar",
       "redirect_document_id": false
     },
     {
       "source_path": "hub/apps/design/shell/tiles-and-notifications/toast-schema.md",
-      "redirect_url": "../../../develop/notifications/app-notifications/toast-schema",
+      "redirect_url": "../../../develop/notifications/app-notifications/app-notifications-schema",
       "redirect_document_id": false
     },
     {
       "source_path": "hub/apps/design/shell/tiles-and-notifications/toast-ux-guidance.md",
-      "redirect_url": "../../../develop/notifications/app-notifications/toast-ux-guidance",
+      "redirect_url": "../../../develop/notifications/app-notifications/app-notifications-ux-guidance",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/develop/notifications/app-notifications/custom-audio-on-notifications.md",
+      "redirect_url": "app-notifications-custom-audio",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/develop/notifications/app-notifications/custom-timestamps-on-notifications.md",
+      "redirect_url": "app-notifications-custom-timestamps",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/develop/notifications/app-notifications/notification-collections.md",
+      "redirect_url": "app-notifications-collections",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/develop/notifications/app-notifications/notification-headers.md",
+      "redirect_url": "app-notifications-headers",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/develop/notifications/app-notifications/notification-pending-update.md",
+      "redirect_url": "app-notifications-pending-update",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/develop/notifications/app-notifications/notification-progress-bar.md",
+      "redirect_url": "app-notifications-progress-bar",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/develop/notifications/app-notifications/notification-schema.md",
+      "redirect_url": "app-notifications-schema",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/develop/notifications/app-notifications/scheduled-notification.md",
+      "redirect_url": "app-notifications-scheduled",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/develop/notifications/app-notifications/toast-ux-guidance.md",
+      "redirect_url": "app-notifications-ux-guidance",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/develop/notifications/app-notifications/app-notifications-uwp.md",
+      "redirect_url": "/uwp/develop/app-notifications-uwp",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/develop/notifications/app-notifications/adaptive-interactive-toasts.md",
+      "redirect_url": "app-notifications-content",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/develop/notifications/app-notifications/send-local-toast.md",
+      "redirect_url": "app-notifications-quickstart",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/develop/notifications/app-notifications/send-local-toast-cpp-uwp.md",
+      "redirect_url": "app-notifications-quickstart",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/develop/notifications/app-notifications/send-local-toast-desktop-cpp-wrl.md",
+      "redirect_url": "app-notifications-quickstart",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/develop/notifications/app-notifications/send-local-toast-other-apps.md",
+      "redirect_url": "app-notifications-other-frameworks",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/develop/notifications/app-notifications/toast-desktop-apps.md",
+      "redirect_url": "app-notifications-quickstart",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/develop/notifications/app-notifications/toast-schema.md",
+      "redirect_url": "app-notifications-schema",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/develop/notifications/app-notifications/scheduled-toast.md",
+      "redirect_url": "app-notifications-scheduled",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/develop/notifications/app-notifications/toast-collections.md",
+      "redirect_url": "app-notifications-collections",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/develop/notifications/app-notifications/toast-headers.md",
+      "redirect_url": "app-notifications-headers",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/develop/notifications/app-notifications/toast-pending-update.md",
+      "redirect_url": "app-notifications-pending-update",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/develop/notifications/app-notifications/toast-progress-bar.md",
+      "redirect_url": "app-notifications-progress-bar",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/develop/notifications/app-notifications/custom-audio-on-toasts.md",
+      "redirect_url": "app-notifications-custom-audio",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/develop/notifications/app-notifications/custom-timestamps-on-toasts.md",
+      "redirect_url": "app-notifications-custom-timestamps",
       "redirect_document_id": false
     },
     {

hub/apps/desktop/modernize/get-activation-info-for-packaged-apps.md

@@ -61,7 +61,7 @@ You can use the [AppInstance.GetActivatedEventArgs](/uwp/api/windows.application
 |-------------------|-----------------|-----------------------|
 | [ShareTargetActivatedEventArgs](/uwp/api/windows.applicationmodel.activation.sharetargetactivatedeventargs) | [uap:ShareTarget](/uwp/schemas/appxpackage/uapmanifestschema/element-uap-sharetarget) | [Integrate packaged apps with Windows Share](../../develop/windows-integration/integrate-sharesheet-packaged.md) |
 | [ProtocolActivatedEventArgs](/uwp/api/windows.applicationmodel.activation.protocolactivatedeventargs) | [uap:Protocol](/uwp/schemas/appxpackage/uapmanifestschema/element-uap-protocol) | [Start your application by using a protocol](./desktop-to-uwp-extensions.md#start-your-application-by-using-a-protocol) |
-| [ToastNotificationActivatedEventArgs](/uwp/api/windows.applicationmodel.activation.toastnotificationactivatedeventargs) | desktop:ToastNotificationActivation | [Toast notifications from desktop apps](/windows/uwp/design/shell/tiles-and-notifications/toast-desktop-apps). |
+| [ToastNotificationActivatedEventArgs](/uwp/api/windows.applicationmodel.activation.toastnotificationactivatedeventargs) | desktop:ToastNotificationActivation | [App notifications quickstart](/windows/apps/develop/notifications/app-notifications/app-notifications-quickstart). |
 | [StartupTaskActivatedEventArgs](/uwp/api/windows.applicationmodel.activation.startuptaskactivatedeventargs)  | desktop:StartupTask | [Start an executable file when users log into Windows](./desktop-to-uwp-extensions.md#start-an-executable-file-when-users-log-into-windows) |
 | [FileActivatedEventArgs](/uwp/api/windows.applicationmodel.activation.fileactivatedeventargs) | [uap:FileTypeAssociation](/uwp/schemas/appxpackage/uapmanifestschema/element-uap-filetypeassociation) | [Associate your packaged application with a set of file types](./desktop-to-uwp-extensions.md#associate-your-packaged-application-with-a-set-of-file-types) |
 | [VoiceCommandActivatedEventArgs](/uwp/api/windows.applicationmodel.activation.voicecommandactivatedeventargs) | None | [Activate a foreground app with voice commands through Cortana](../../design/input/cortana-launch-a-foreground-app-with-voice-commands.md) |

hub/apps/develop/notifications/app-notifications/app-notifications-additional-features.md

@@ -0,0 +1,31 @@
+---
+description: Explore additional app notification features in the Windows App SDK, including removing notifications, scheduling, custom audio, progress bars, and organizing with collections and headers.
+title: Additional App Notification Features
+label: Additional app notification features
+template: detail.hbs
+ms.date: 07/28/2025
+ms.topic: article
+keywords: windows 11, windows app sdk, winappsdk, notification, features
+ms.localizationpriority: medium
+---
+# Additional app notification features
+
+The articles in this section describe app notifications features such as how to manage notification lifecycle, customize appearance and behavior, and organize notifications in Notification Center. To get started using app notifications in a Windows app, see [Quickstart: App notifications](app-notifications-quickstart.md).
+
+| Feature | Description |
+|---------|-------------|
+| [Remove notifications](manage-app-notifications.md) | Tag, group, remove, and set expiration on notifications. |
+| [Schedule notifications](app-notifications-scheduled.md) | Schedule a notification to appear at a future time. |
+| [Custom audio](app-notifications-custom-audio.md) | Use your app's own sound effects for notifications. |
+| [Progress bar](app-notifications-progress-bar.md) | Display and update a progress bar inside a notification. |
+| [Pending update](app-notifications-pending-update.md) | Create multi-step interactions with pending update activation. |
+| [Custom timestamps](app-notifications-custom-timestamps.md) | Override the system timestamp with a custom time. |
+| [Collections](app-notifications-collections.md) | Organize notifications into collections in Notification Center. |
+| [Headers](app-notifications-headers.md) | Group notifications under headers in Notification Center. |
+| [Notification Listener](notification-listener.md) | Access and monitor all notifications on the device. |
+
+## See also
+
+- [App notifications overview](index.md)
+- [Quickstart: App notifications](app-notifications-quickstart.md)
+- [App notification content](app-notifications-content.md)

hub/apps/develop/notifications/app-notifications/app-notifications-collections.md

@@ -0,0 +1,118 @@
+---
+description: Learn how to organize app notifications by creating, updating, or removing notification collections in Notification Center.
+title: App notification collections
+label: App notification collections
+template: detail.hbs
+ms.date: 07/28/2025
+ms.topic: how-to
+keywords: windows 11, windows app sdk, winappsdk, notification, collections, collection, group notifications, grouping notifications, group, organize, Notification Center
+ms.localizationpriority: medium
+---
+# App notification collections
+
+Use collections to organize your app's notifications in Notification Center. Collections help users locate information more easily and allow developers to better manage their notifications.
+
+A messaging app, for example, can separate notifications by chat group. Each group title ("Comp Sci 160A Project Chat", "Direct Messages", "Lacrosse Team Chat") is a separate collection. Notifications are grouped as if they were from a separate app, even though they all come from the same app. For a more subtle way to organize notifications, see [App notification headers](app-notifications-headers.md).
+
+![Collection Example with two different Groups of Notifications](images/toast-collection-example.png)
+
+> [!NOTE]
+> The code examples in this article use the `Microsoft.Windows.AppNotifications` namespace to build notification content and the `Windows.UI.Notifications` namespace for collection management. These two namespaces can be used together in the same app.
+
+For more information about app notifications, see [App notifications overview](index.md).
+
+## Create a collection
+
+When creating a collection, provide a display name and an icon, which are shown in Notification Center as part of the collection's title. Collections also require a launch argument so your app can navigate to the right location when the user clicks the collection title. Create the collection by calling [**SaveToastCollectionAsync**](/uwp/api/windows.ui.notifications.toastcollectionmanager.savetoastcollectionasync).
+
+```csharp
+using Windows.UI.Notifications;
+
+var collection = new ToastCollection(
+    "MyToastCollection",
+    "Work Email",
+    "NavigateToWorkEmailInbox",
+    new Uri("ms-appx:///Assets/workEmail.png"));
+
+await ToastNotificationManager.GetDefault()
+    .GetToastCollectionManager()
+    .SaveToastCollectionAsync(collection);
+```
+
+## Send a notification to a collection
+
+Use [**AppNotificationBuilder**](/windows/windows-app-sdk/api/winrt/microsoft.windows.appnotifications.builder.appnotificationbuilder) to construct the notification content, then call [**GetToastNotifierForToastCollectionIdAsync**](/uwp/api/windows.ui.notifications.toastnotificationmanagerforuser.gettoastnotifierfortoastcollectionidasync) to get a notifier scoped to the collection.
+
+```csharp
+using Microsoft.Windows.AppNotifications.Builder;
+using Windows.UI.Notifications;
+using Windows.Data.Xml.Dom;
+
+// Build notification content with Windows App SDK
+var payload = new AppNotificationBuilder()
+    .AddText("Adam sent a message to the group")
+    .BuildNotification()
+    .Payload;
+
+// Deliver to a collection using the WinRT API
+var doc = new XmlDocument();
+doc.LoadXml(payload);
+var toast = new ToastNotification(doc);
+
+var notifier = await ToastNotificationManager.GetDefault()
+    .GetToastNotifierForToastCollectionIdAsync("MyToastCollection");
+notifier.Show(toast);
+```
+
+## List all collections
+
+Retrieve all collections created for your app by calling [**FindAllToastCollectionsAsync**](/uwp/api/windows.ui.notifications.toastcollectionmanager.findalltoastcollectionsasync).
+
+```csharp
+var collectionManager = ToastNotificationManager.GetDefault().GetToastCollectionManager();
+var collections = await collectionManager.FindAllToastCollectionsAsync();
+```
+
+## Update a collection
+
+Update a collection by creating a new [**ToastCollection**](/uwp/api/windows.ui.notifications.toastcollection) instance with the same ID and calling [**SaveToastCollectionAsync**](/uwp/api/windows.ui.notifications.toastcollectionmanager.savetoastcollectionasync).
+
+```csharp
+var collectionManager = ToastNotificationManager.GetDefault().GetToastCollectionManager();
+
+var updatedCollection = new ToastCollection(
+    "MyToastCollection",
+    "Updated Display Name",
+    "UpdatedLaunchArgs",
+    new Uri("ms-appx:///Assets/updatedPicture.png"));
+
+await collectionManager.SaveToastCollectionAsync(updatedCollection);
+```
+
+## Remove a collection
+
+Remove a collection by calling [**RemoveToastCollectionAsync**](/uwp/api/windows.ui.notifications.toastcollectionmanager.removetoastcollectionasync) with the collection ID. Any notifications in the collection are also removed from Notification Center.
+
+```csharp
+var collectionManager = ToastNotificationManager.GetDefault().GetToastCollectionManager();
+await collectionManager.RemoveToastCollectionAsync("MyToastCollection");
+```
+
+## Remove notifications within a collection
+
+Use the **Tag** and **Group** properties to identify and remove individual notifications within a collection by calling [**Remove**](/uwp/api/windows.ui.notifications.toastnotificationhistory.remove), or clear all notifications at once with [**Clear**](/uwp/api/windows.ui.notifications.toastnotificationhistory.clear).
+
+```csharp
+var collectionHistory = await ToastNotificationManager.GetDefault()
+    .GetHistoryForToastCollectionAsync("MyToastCollection");
+
+// Remove a specific notification
+collectionHistory.Remove(tag, group);
+
+// Or clear all notifications in the collection
+collectionHistory.Clear();
+```
+
+## See also
+
+- [App notifications overview](index.md)