Clarify FlyoutDisplayOptions.AsSingleItem vs AsMultipleItems documentation

[Copilot]

Fixes #2909. The existing documentation for FlyoutDisplayOptions was too terse to understand the practical difference between AsSingleItem and AsMultipleItems.

Changes

• AsSingleItem: Clarified that the FlyoutItem appears as a single flyout entry regardless of child count; children are accessed via tabs
• AsMultipleItems: Clarified that each child Tab/ShellContent becomes a separate flyout entry for direct navigation
• Usage guidance: Added when-to-use recommendation for each option

Before:

AsSingleItem, indicates that the item will be visible as a single item.

After:

AsSingleItem, indicates that the FlyoutItem will be visible as a single entry in the flyout, regardless of how many child Tab or ShellContent objects it contains. When selected, the first child content is displayed, and users can switch between children using tabs (if more than one child exists).

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Can't understand FlyoutDisplayOptions.AsSingleItem from reading the document</issue_title>
<issue_description>### Type of issue

Typo

Description

Honestly I can't see the difference between AsSingleItem and AsMultipleItems, and under which circumstance should I choose to use single item and why the single item becomes the default, as most of the code I see online use multiple option.

Page URL

https://learn.microsoft.com/en-us/dotnet/maui/fundamentals/shell/flyout?view=net-maui-9.0

Content source URL

https://github.com/dotnet/docs-maui/blob/main/docs/fundamentals/shell/flyout.md

Document Version Independent Id

05d3c8f0-3066-5129-e6cd-3c3d05fcbb59

Platform Id

f127f349-56f2-2c0e-e5d4-1f7a087d8679

Article author

@davidbritch

Metadata

• ID: 05d3c8f0-3066-5129-e6cd-3c3d05fcbb59
• PlatformId: f127f349-56f2-2c0e-e5d4-1f7a087d8679
• Service: dotnet-mobile
• Sub-service: dotnet-maui

Related Issues</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes Can't understand FlyoutDisplayOptions.AsSingleItem from reading the document #2909

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

---

Internal previews

📄 File	🔗 Preview link
docs/fundamentals/shell/flyout.md	docs/fundamentals/shell/flyout

[learn-build-service-prod]

Learn Build status updates of commit 6412fff:

✅ Validation status: passed

For more details, please refer to the build report.

[learn-build-service-prod]

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]

Learn Build status updates of commit 5c2b214:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/fundamentals/shell/flyout.md	✅Succeeded	View (>=net-maui-8.0)

For more details, please refer to the build report.

[learn-build-service-prod]

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]

Learn Build status updates of commit ef161ae:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/fundamentals/shell/flyout.md	✅Succeeded	View (>=net-maui-8.0)

For more details, please refer to the build report.