Skip to content

Update Snackbar and Toast documentation to clarify Windows packaging … - #655

Draft
ne0rrmatrix wants to merge 1 commit into
MicrosoftDocs:mainfrom
ne0rrmatrix:SnackbarChanges
Draft

Update Snackbar and Toast documentation to clarify Windows packaging …#655
ne0rrmatrix wants to merge 1 commit into
MicrosoftDocs:mainfrom
ne0rrmatrix:SnackbarChanges

Conversation

@ne0rrmatrix

Copy link
Copy Markdown
Contributor

This pull request updates the .NET MAUI documentation to clarify that both Snackbar and Toast notifications on Windows require a packaged (MSIX) app. It adds important warnings and instructions to help developers avoid runtime errors and understand the platform requirements. The most important changes are grouped below.

Platform requirements and warnings:

  • Added explicit [!IMPORTANT] notes to the snackbar.md and shared setup documentation, stating that Snackbar and Toast on Windows require a packaged (MSIX) app because the underlying AppNotificationManager API is only available with packaged app identity. Provided guidance for unpackaged apps and described the exception and diagnostic behavior. [1] [2]
  • Updated the setup instructions to clarify that handler registration for Snackbar and Toast is only performed in packaged apps; in unpackaged apps, registration is skipped and a diagnostic message is logged.
  • Added a note to the Toast documentation highlighting the packaged app requirement on Windows.

Documentation clarity:

  • Improved the language in setup steps to consistently refer to both Snackbar and Toast and to clarify the enabling process for Windows.
  • Minor formatting and sectioning improvements for better readability in the Toast documentation.

@ne0rrmatrix
ne0rrmatrix marked this pull request as draft August 2, 2026 18:47
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit e28b164:

✅ Validation status: passed

File Status Preview URL Details
docs/maui/alerts/snackbar.md ✅Succeeded View
docs/maui/alerts/toast.md ✅Succeeded View
docs/maui/includes/toast-snackbar-setup.md ✅Succeeded View

For more details, please refer to the build report.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant