Rename send-local-toast files to app-notification-[framework]

drewbatgit · Copilot · drewbatgit · commit a5bec3dae597 · 2026-04-08T15:23:22.000-07:00
Renamed all send-local-toast-*.md files to app-notification-*.md.
Updated TOC and all cross-references across notification docs.

Co-authored-by: Copilot &lt;223556219+Copilot@users.noreply.github.com&gt;
diff --git a/hub/apps/develop/notifications/app-notifications/adaptive-interactive-toasts.md b/hub/apps/develop/notifications/app-notifications/adaptive-interactive-toasts.md
@@ -25,13 +25,13 @@ App notifications are defined with an XML payload that is defined by the [App no
 
 **Install Notifications Visualizer.** This free Windows app helps you design interactive app notifications by providing an instant visual preview of your toast as you edit it, similar to Visual Studio's XAML editor/design view. See [Notifications Visualizer](../notifications-visualizer.md) for more information, or [download Notifications Visualizer from the Store](https://apps.microsoft.com/detail/9nblggh5xsl1).
 
-This article only covers creating the app notification content. For information on sending a notification after you have generated the XML payload, see [Send a local app notification](send-local-toast.md). 
+This article only covers creating the app notification content. For information on sending a notification after you have generated the XML payload, see [Send a local app notification](app-notification-csharp-legacy.md). 
 
 ## App notification structure
 
 Some important, high-level components of an app notification XML payload include:
 
-- **toast**: The **launch** attribute of this element defines what arguments will be passed back to your app when the user clicks your toast, allowing you to deep link into the correct content that the toast was displaying. To learn more, see [Send a local app notification](send-local-toast.md).
+- **toast**: The **launch** attribute of this element defines what arguments will be passed back to your app when the user clicks your toast, allowing you to deep link into the correct content that the toast was displaying. To learn more, see [Send a local app notification](app-notification-csharp-legacy.md).
 - **visual**: This element represents visual portion of the toast, including the generic binding that contains text and images.
 - **actions**: This element represents interactive portion of the toast, including inputs and actions.
 - **audio**: This element specifies the audio played when the toast is shown to the user.
@@ -366,7 +366,7 @@ Here's an example where columns and some advanced adaptive text elements are use
 
 Buttons make your toast interactive, letting the user take quick actions on your app notification without interrupting their current workflow. For example, users can reply to a message directly from within a toast, or delete an email without even opening the email app. Buttons appear in the expanded portion of your notification.
 
-To learn more about implementing buttons end-to-end, see [Send local toast](send-local-toast.md).
+To learn more about implementing buttons end-to-end, see [Send local toast](app-notification-csharp-legacy.md).
 
 Buttons can activate an app in the following ways:
 
@@ -969,9 +969,10 @@ Your tiles and app notifications can load strings and images tailored for displa
 
 
 ## Handling activation
-To learn how to handle app activations (the user clicking your toast or buttons on the toast), see [Send local toast](send-local-toast.md).
+To learn how to handle app activations (the user clicking your toast or buttons on the toast), see [Send local toast](app-notification-csharp-legacy.md).
  
 ## Related topics
 
-* [Send a local toast and handle activation](send-local-toast.md)
+* [Send a local toast and handle activation](app-notification-csharp-legacy.md)
 * [Tile and toast notification support for language, scale, and high contrast](/windows/uwp/launch-resume/tile-toast-language-scale-contrast)
+
diff --git a/hub/apps/develop/notifications/app-notifications/app-notification-console.md b/hub/apps/develop/notifications/app-notifications/app-notification-console.md
@@ -16,7 +16,7 @@ An app notification is a message that your app can construct and deliver to your
 This article walks you through the steps to send and handle app notifications from a .NET console app using the [Windows App SDK](/windows/apps/windows-app-sdk/). The Windows App SDK `Microsoft.Windows.AppNotifications` APIs handle all the complexity of notification registration and activation for both packaged and unpackaged apps.
 
 > [!NOTE]
-> For WinUI apps, see [Quickstart: App notifications in the Windows App SDK](app-notifications-quickstart.md). For other app types, see [WPF](send-local-toast-wpf.md), [WinForms](send-local-toast-winforms.md), or [UWP](send-local-toast-uwp.md).
+> For WinUI apps, see [Quickstart: App notifications in the Windows App SDK](app-notifications-quickstart.md). For other app types, see [WPF](app-notification-wpf.md), [WinForms](app-notification-winforms.md), or [UWP](app-notification-uwp.md).
 
 > [!IMPORTANT]
 > Notifications for elevated (admin) apps are not currently supported.
@@ -144,3 +144,4 @@ AppNotificationManager.Default.Unregister();
 - [App notification content](adaptive-interactive-toasts.md)
 - [AppNotificationManager Class](/windows/windows-app-sdk/api/winrt/microsoft.windows.appnotifications.appnotificationmanager)
 - [AppNotificationBuilder Class](/windows/windows-app-sdk/api/winrt/microsoft.windows.appnotifications.builder.appnotificationbuilder)
+
diff --git a/hub/apps/develop/notifications/app-notifications/app-notification-cpp-uwp.md b/hub/apps/develop/notifications/app-notifications/app-notification-cpp-uwp.md
@@ -22,7 +22,7 @@ This quickstart walks you through the steps to create, deliver, and display a Wi
 > The term "toast notification" is being replaced with "app notification". These terms both refer to the same feature of Windows, but over time we will phase out the use of "toast notification" in the documentation.
 
 > [!IMPORTANT]
-> If you're writing a C++ non-UWP app, please see the [C++ WRL](send-local-toast-desktop-cpp-wrl.md) documentation. If you're writing a C# app, please see the [C# documentation](send-local-toast.md).
+> If you're writing a C++ non-UWP app, please see the [C++ WRL](app-notification-cpp-wrl.md) documentation. If you're writing a C# app, please see the [C# documentation](app-notification-csharp-legacy.md).
 
 > [!NOTE]
 > For C++ apps using the Windows App SDK, see [Quickstart: App notifications in the Windows App SDK](app-notifications-quickstart.md) which covers the recommended approach using the `Microsoft.Windows.AppNotifications` APIs.
@@ -380,3 +380,4 @@ toastManager.History().Clear();
 * [App content documentation](adaptive-interactive-toasts.md)
 * [ToastNotification Class](/uwp/api/Windows.UI.Notifications.ToastNotification)
 * [ToastNotificationActivatedEventArgs Class](/uwp/api/Windows.ApplicationModel.Activation.ToastNotificationActivatedEventArgs)
+
diff --git a/hub/apps/develop/notifications/app-notifications/app-notification-cpp-wrl.md b/hub/apps/develop/notifications/app-notifications/app-notification-cpp-wrl.md
@@ -199,3 +199,4 @@ int WINAPI wWinMain(_In_ HINSTANCE hInstance, _In_opt_ HINSTANCE, _In_ LPWSTR cm
 * [Full code sample on GitHub](https://github.com/WindowsNotifications/desktop-toasts)
 * [App notification content documentation](adaptive-interactive-toasts.md)
 * [Quickstart: App notifications in the Windows App SDK](app-notifications-quickstart.md)
+
diff --git a/hub/apps/develop/notifications/app-notifications/app-notification-csharp-legacy.md b/hub/apps/develop/notifications/app-notifications/app-notification-csharp-legacy.md
@@ -22,7 +22,7 @@ This quickstart walks you through the steps to create, deliver, and display a Wi
 > The term "toast notification" is being replaced with "app notification".These terms both refer to the same feature of Windows, but over time we will phase out the use of "toast notification" in the documentation.
 
 > [!IMPORTANT]
-> If you're writing a C++ app, please see the [C++ UWP](send-local-toast-cpp-uwp.md) or [C++ WRL](send-local-toast-desktop-cpp-wrl.md) documentation.
+> If you're writing a C++ app, please see the [C++ UWP](app-notification-cpp-uwp.md) or [C++ WRL](app-notification-cpp-wrl.md) documentation.
 
 ## Step 1: Add namespace references
 
@@ -439,3 +439,4 @@ await AppNotificationManager.Default.RemoveAllAsync();
 * [AppNotificationBuilder Class](/windows/windows-app-sdk/api/winrt/microsoft.windows.appnotifications.builder.appnotificationbuilder)
 * [ToastNotification Class](/uwp/api/Windows.UI.Notifications.ToastNotification)
 * [ToastNotificationActivatedEventArgs Class](/uwp/api/Windows.ApplicationModel.Activation.ToastNotificationActivatedEventArgs)
+
diff --git a/hub/apps/develop/notifications/app-notifications/app-notification-other-apps.md b/hub/apps/develop/notifications/app-notifications/app-notification-other-apps.md
@@ -24,7 +24,7 @@ An app notification is a message that an app can construct and deliver to the us
 > The term "toast notification" is being replaced with "app notification". These terms both refer to the same feature of Windows, but over time we will phase out the use of "toast notification" in the documentation.
 
 > [!IMPORTANT]
-> If you're writing a C# app, then please see the [C# documentation](send-local-toast.md). If you're writing a C++ app, the please see the [C++ UWP](send-local-toast-cpp-uwp.md) or [C++ WRL](send-local-toast-desktop-cpp-wrl.md) documentation.
+> If you're writing a C# app, then please see the [C# documentation](app-notification-csharp-legacy.md). If you're writing a C++ app, the please see the [C++ UWP](app-notification-cpp-uwp.md) or [C++ WRL](app-notification-cpp-wrl.md) documentation.
 
 > [!NOTE]
 > If your app can use the Windows App SDK, see [Quickstart: App notifications in the Windows App SDK](app-notifications-quickstart.md) for the recommended approach.
@@ -125,3 +125,4 @@ Your COM activator will be activated when your notification is clicked.
 ### AUMID restrictions
 
 The AUMID should be at most 129 characters long. If the AUMID is more than 129 characters long, scheduled app notifications won't work - you'll get the following exception when adding a scheduled notification: *The data area passed to a system call is too small. (0x8007007A)*.
+
diff --git a/hub/apps/develop/notifications/app-notifications/app-notification-uwp.md b/hub/apps/develop/notifications/app-notifications/app-notification-uwp.md
@@ -19,7 +19,7 @@ This article walks you through the steps to send and handle app notifications fr
 > For new desktop apps, we recommend using the [Windows App SDK](/windows/apps/windows-app-sdk/) instead. See [Quickstart: App notifications in the Windows App SDK](app-notifications-quickstart.md) for the recommended approach using the `Microsoft.Windows.AppNotifications` APIs.
 
 > [!NOTE]
-> For other app types, see [WPF](send-local-toast-wpf.md), [WinForms](send-local-toast-winforms.md), or [Console](send-local-toast-console.md).
+> For other app types, see [WPF](app-notification-wpf.md), [WinForms](app-notification-winforms.md), or [Console](app-notification-console.md).
 
 ## Prerequisites
 
@@ -309,3 +309,4 @@ Background task registration and handling in C++ follows the same pattern. For d
 - [App notification content](adaptive-interactive-toasts.md)
 - [ToastNotification Class](/uwp/api/Windows.UI.Notifications.ToastNotification)
 - [ToastNotificationActivatedEventArgs Class](/uwp/api/Windows.ApplicationModel.Activation.ToastNotificationActivatedEventArgs)
+
diff --git a/hub/apps/develop/notifications/app-notifications/app-notification-winforms.md b/hub/apps/develop/notifications/app-notifications/app-notification-winforms.md
@@ -16,7 +16,7 @@ An app notification is a message that your app can construct and deliver to your
 This article walks you through the steps to send and handle app notifications from a WinForms app using the [Windows App SDK](/windows/apps/windows-app-sdk/). The Windows App SDK `Microsoft.Windows.AppNotifications` APIs handle all the complexity of notification registration and activation for both packaged and unpackaged apps.
 
 > [!NOTE]
-> For WinUI apps, see [Quickstart: App notifications in the Windows App SDK](app-notifications-quickstart.md). For other app types, see [WPF](send-local-toast-wpf.md), [Console](send-local-toast-console.md), or [UWP](send-local-toast-uwp.md).
+> For WinUI apps, see [Quickstart: App notifications in the Windows App SDK](app-notifications-quickstart.md). For other app types, see [WPF](app-notification-wpf.md), [Console](app-notification-console.md), or [UWP](app-notification-uwp.md).
 
 > [!IMPORTANT]
 > Notifications for elevated (admin) apps are not currently supported.
@@ -160,11 +160,12 @@ AppNotificationManager.Default.Show(notification);
 
 ## Packaged app setup
 
-For unpackaged WinForms apps, `Register()` handles COM registration automatically. For packaged apps (MSIX), you need to add extensions to your `Package.appxmanifest`. See [Packaged app setup](send-local-toast-wpf.md#packaged-app-setup) in the WPF article for the required manifest entries.
+For unpackaged WinForms apps, `Register()` handles COM registration automatically. For packaged apps (MSIX), you need to add extensions to your `Package.appxmanifest`. See [Packaged app setup](app-notification-wpf.md#packaged-app-setup) in the WPF article for the required manifest entries.
 
 ## Related content
 
 - [Quickstart: App notifications in the Windows App SDK](app-notifications-quickstart.md)
 - [App notification content](adaptive-interactive-toasts.md)
 - [AppNotificationManager Class](/windows/windows-app-sdk/api/winrt/microsoft.windows.appnotifications.appnotificationmanager)
 - [AppNotificationBuilder Class](/windows/windows-app-sdk/api/winrt/microsoft.windows.appnotifications.builder.appnotificationbuilder)
+
diff --git a/hub/apps/develop/notifications/app-notifications/app-notification-wpf.md b/hub/apps/develop/notifications/app-notifications/app-notification-wpf.md
@@ -16,7 +16,7 @@ An app notification is a message that your app can construct and deliver to your
 This article walks you through the steps to send and handle app notifications from a WPF app using the [Windows App SDK](/windows/apps/windows-app-sdk/). The Windows App SDK `Microsoft.Windows.AppNotifications` APIs handle all the complexity of notification registration and activation for both packaged and unpackaged apps.
 
 > [!NOTE]
-> For WinUI apps, see [Quickstart: App notifications in the Windows App SDK](app-notifications-quickstart.md). For other app types, see [WinForms](send-local-toast-winforms.md), [Console](send-local-toast-console.md), or [UWP](send-local-toast-uwp.md).
+> For WinUI apps, see [Quickstart: App notifications in the Windows App SDK](app-notifications-quickstart.md). For other app types, see [WinForms](app-notification-winforms.md), [Console](app-notification-console.md), or [UWP](app-notification-uwp.md).
 
 > [!IMPORTANT]
 > Notifications for elevated (admin) apps are not currently supported.
@@ -253,3 +253,4 @@ For unpackaged WPF apps, `Register()` handles COM registration automatically. Fo
 - [App notification content](adaptive-interactive-toasts.md)
 - [AppNotificationManager Class](/windows/windows-app-sdk/api/winrt/microsoft.windows.appnotifications.appnotificationmanager)
 - [AppNotificationBuilder Class](/windows/windows-app-sdk/api/winrt/microsoft.windows.appnotifications.builder.appnotificationbuilder)
+
diff --git a/hub/apps/develop/notifications/app-notifications/custom-audio-on-toasts.md b/hub/apps/develop/notifications/app-notifications/custom-audio-on-toasts.md
@@ -77,11 +77,12 @@ Supported audio file sources:
 
 ## Send the notification
 
-Sending a notification with audio is the same as sending a regular notification. For Windows App SDK apps, use `AppNotificationManager.Default.Show()`. See [Send local toast](send-local-toast.md) to learn more.
+Sending a notification with audio is the same as sending a regular notification. For Windows App SDK apps, use `AppNotificationManager.Default.Show()`. See [Send local toast](app-notification-csharp-legacy.md) to learn more.
 
 
 ## Related topics
 
 - [Full code sample on GitHub](https://github.com/WindowsNotifications/quickstart-toast-with-custom-audio)
-- [Send a local toast](send-local-toast.md)
+- [Send a local toast](app-notification-csharp-legacy.md)
 - [Toast content documentation](adaptive-interactive-toasts.md)
+
diff --git a/hub/apps/develop/notifications/app-notifications/custom-timestamps-on-toasts.md b/hub/apps/develop/notifications/app-notifications/custom-timestamps-on-toasts.md
@@ -73,5 +73,5 @@ If you sent a local notification, we use the time when the notification platform
 
 ## Related topics
 
-- [Send a local toast](send-local-toast.md)
-- [App notification content documentation](adaptive-interactive-toasts.md)
+- [Send a local toast](app-notification-csharp-legacy.md)
+- [App notification content documentation](adaptive-interactive-toasts.md)
diff --git a/hub/apps/develop/notifications/app-notifications/index.md b/hub/apps/develop/notifications/app-notifications/index.md
@@ -21,10 +21,10 @@ This section provides design and implementation guidance for app notifications i
 ## App notification UX and implementation guidance
 
 - [App notification UX guidance](toast-ux-guidance.md)
-- [Send a local app notification from C# apps](send-local-toast.md)
-- [Send a local app notification from C++ UWP apps](send-local-toast-cpp-uwp.md)
-- [Send a local app notification from Win32 C++ WRL apps](send-local-toast-desktop-cpp-wrl.md)
-- [Send a local app notification from other types of unpackaged apps](send-local-toast-other-apps.md)
+- [Send a local app notification from C# apps](app-notification-csharp-legacy.md)
+- [Send a local app notification from C++ UWP apps](app-notification-cpp-uwp.md)
+- [Send a local app notification from Win32 C++ WRL apps](app-notification-cpp-wrl.md)
+- [Send a local app notification from other types of unpackaged apps](app-notification-other-apps.md)
 - [App notification content](adaptive-interactive-toasts.md)
 - [App notification content schema](toast-schema.md)
 - [Schedule an app notification](scheduled-toast.md)
@@ -48,3 +48,4 @@ The app notifications support in the Windows App SDK currently has these limitat
 ## Next steps
 
 See [Quickstart: App notifications in the Windows App SDK](app-notifications-quickstart.md) to get started.
+
diff --git a/hub/apps/develop/notifications/app-notifications/scheduled-toast.md b/hub/apps/develop/notifications/app-notifications/scheduled-toast.md
@@ -127,15 +127,16 @@ await AppNotificationManager.Default.RemoveByGroupAsync("ASTR 170B1");
 
 ## Activation handling
 
-See the [send a local app notification](send-local-toast.md) docs to learn more about handling activation. Activation of a scheduled app notification is handled the same as activation of a local app notification.
+See the [send a local app notification](app-notification-csharp-legacy.md) docs to learn more about handling activation. Activation of a scheduled app notification is handled the same as activation of a local app notification.
 
 ## Adding actions, inputs, and more
 
-See the [send a local app notification](send-local-toast.md) docs to learn more about advanced topics like actions and inputs. Actions and inputs work the same in local app notifications as they do in scheduled app notifications.
+See the [send a local app notification](app-notification-csharp-legacy.md) docs to learn more about advanced topics like actions and inputs. Actions and inputs work the same in local app notifications as they do in scheduled app notifications.
 
 ## Resources
 
 * [App notification content documentation](adaptive-interactive-toasts.md)
 * [AppNotificationManager class](/windows/windows-app-sdk/api/winrt/microsoft.windows.appnotifications.appnotificationmanager)
 * [AppNotificationBuilder class](/windows/windows-app-sdk/api/winrt/microsoft.windows.appnotifications.builder.appnotificationbuilder)
 * [ScheduledToastNotification Class](/uwp/api/Windows.UI.Notifications.ScheduledToastNotification)
+
diff --git a/hub/apps/develop/notifications/app-notifications/toast-desktop-apps.md b/hub/apps/develop/notifications/app-notifications/toast-desktop-apps.md
@@ -35,7 +35,7 @@ The table below illustrates your options for supporting app notifications within
 
 ## Preferred option - COM activator
 
-This is the preferred option that works for desktop apps, and supports all notification features. Don't be afraid of the "COM activator"; we have a library [for C#](send-local-toast.md) and [C++ apps](send-local-toast-desktop-cpp-wrl.md) that makes this very straightforward, even if you've never written a COM server before.<br/><br/>
+This is the preferred option that works for desktop apps, and supports all notification features. Don't be afraid of the "COM activator"; we have a library [for C#](app-notification-csharp-legacy.md) and [C++ apps](app-notification-cpp-wrl.md) that makes this very straightforward, even if you've never written a COM server before.<br/><br/>
 
 | Visuals | Actions | Inputs | Activates in-process |
 | -- | -- | -- | -- |
@@ -53,7 +53,7 @@ With the COM activator option, you can use the following notification templates
 > [!NOTE]
 > If you add the COM activator to your existing packaged app, then Foreground/Background and Legacy notification activations will activate your COM activator instead of your command line.
 
-To learn how to use this option, see [Send a local app notification from desktop C# apps](send-local-toast.md) or [Send a local app notification from Win32 C++ WRL apps](send-local-toast-desktop-cpp-wrl.md).
+To learn how to use this option, see [Send a local app notification from desktop C# apps](app-notification-csharp-legacy.md) or [Send a local app notification from Win32 C++ WRL apps](app-notification-cpp-wrl.md).
 
 ## Alternative option - No COM / Stub CLSID
 
@@ -78,6 +78,7 @@ For unpackaged apps, set up the AUMID so that you can send notifications, and th
 
 ## Resources
 
-* [Send a local app notification from desktop C# apps](send-local-toast.md)
-* [Send a local app notification from Win32 C++ WRL apps](send-local-toast-desktop-cpp-wrl.md)
+* [Send a local app notification from desktop C# apps](app-notification-csharp-legacy.md)
+* [Send a local app notification from Win32 C++ WRL apps](app-notification-cpp-wrl.md)
 * [App notification content documentation](adaptive-interactive-toasts.md)
+
diff --git a/hub/apps/develop/notifications/app-notifications/toast-headers.md b/hub/apps/develop/notifications/app-notifications/toast-headers.md
diff --git a/hub/apps/develop/notifications/app-notifications/toast-pending-update.md b/hub/apps/develop/notifications/app-notifications/toast-pending-update.md
diff --git a/hub/apps/develop/notifications/app-notifications/toast-ux-guidance.md b/hub/apps/develop/notifications/app-notifications/toast-ux-guidance.md
diff --git a/hub/apps/develop/toc.yml b/hub/apps/develop/toc.yml
