Skip to content

Clarify FlyoutDisplayOptions.AsSingleItem vs AsMultipleItems documentation #3115

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
Copilot wants to merge 2 commits into
base: main
Choose a base branch
from
Draft

Clarify FlyoutDisplayOptions.AsSingleItem vs AsMultipleItems documentation #3115

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
6412fff
Initial plan
Copilot Nov 28, 2025
5c2b214
Clarify FlyoutDisplayOptions.AsSingleItem vs AsMultipleItems document…
Copilot Nov 28, 2025
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
8 changes: 5 additions & 3 deletions docs/fundamentals/shell/flyout.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: ".NET MAUI Shell flyout"
description: "Learn how to customize and control a .NET MAUI flyout, which is the optional root menu for a .NET MAUI Shell app."
ms.date: 08/30/2024
ms.date: 11/28/2025
---

# .NET MAUI Shell flyout
Expand Down Expand Up @@ -74,8 +74,10 @@ This implicit conversion automatically wraps each <xref:Microsoft.Maui.Controls.

The `FlyoutItem.FlyoutDisplayOptions` property configures how a flyout item and its children are displayed in the flyout. This property should be set to a <xref:Microsoft.Maui.Controls.FlyoutDisplayOptions> enumeration member:

- `AsSingleItem`, indicates that the item will be visible as a single item. This is the default value of the <xref:Microsoft.Maui.Controls.FlyoutDisplayOptions> property.
- `AsMultipleItems`, indicates that the item and its direct children will be visible in the flyout as a group of items.
- `AsSingleItem`, indicates that the <xref:Microsoft.Maui.Controls.FlyoutItem> will be visible as a single entry in the flyout, regardless of how many child <xref:Microsoft.Maui.Controls.Tab> or <xref:Microsoft.Maui.Controls.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). This is the default value of the <xref:Microsoft.Maui.Controls.FlyoutDisplayOptions> property.
- `AsMultipleItems`, indicates that the direct children (<xref:Microsoft.Maui.Controls.Tab> and <xref:Microsoft.Maui.Controls.ShellContent> objects) of the <xref:Microsoft.Maui.Controls.FlyoutItem> will each appear as separate entries in the flyout. This enables users to navigate directly to any child content from the flyout, rather than having to use tabs.

Use `AsSingleItem` when you want to group related pages under a single flyout entry with tab navigation. Use `AsMultipleItems` when you want each page to be directly accessible from the flyout menu.

A flyout item for each <xref:Microsoft.Maui.Controls.Tab> object within a <xref:Microsoft.Maui.Controls.FlyoutItem> can be displayed by setting the `FlyoutItem.FlyoutDisplayOptions` property to `AsMultipleItems`:

Expand Down