Blogs
.NET MAUI Bottom Sheet displaying task details

Summarize this blog post with:

TL;DR: Meet the new Syncfusion .NET MAUI Bottom Sheet control, a new way to display contextual information through interactive slide-up panels. Learn how to customize its appearance, configure swipe behavior, manage expansion states, and build a task-details panel in your .NET MAUI application.

Want to display additional information in your .NET MAUI app without navigating users away from their current screen? A Bottom Sheet makes this possible by presenting content in a panel that slides up from the bottom, keeping the underlying screen within reach.

Creating this interaction from scratch means handling layouts, gestures, animations, and different presentation states. The new Syncfusion .NET MAUI Bottom Sheet control simplifies the process with a customizable panel, built-in interaction states, and programmatic control.

Available through the Syncfusion.Maui.BottomSheet NuGet package, the control is included in Essential Studio® 2026 Volume 3 SP.

In this article, we’ll explore its key features and build a task management example that displays task details in a Bottom Sheet.

When should you use a Bottom Sheet?

A Bottom Sheet works well when you want to show additional content without taking users away from their current page. Here are some common scenarios:

  • Product details and quick actions in e-commerce applications
  • Filter and sorting panels
  • Location details in mapping applications
  • Item previews in lists and dashboards
  • Media playback controls
  • Task details and editing forms

Instead of opening another page, users can access the information they need and return to their current task without extra navigation.

Key features of the .NET MAUI Bottom Sheet

The .NET MAUI Bottom Sheet includes several features to help you customize its appearance and behavior:

  • Grabber customization
  • Custom content width
  • Header-only swiping for scrollable content
  • Modal, non-modal, and overlay tap behavior
  • Allowed states to control how users can drag the sheet
  • Hidden, collapsed, half-expanded, and full-expanded states with adjustable heights
  • Background, corner radius, padding, and light and dark themes
  • Programmatic open, close, and state-change events
  • Support for hosting any .NET MAUI view

Let’s see how these features work and where they can help.

Customize the grabber

The grabber is the small handle at the top of the sheet. It gives users a visual cue that they can drag the Bottom Sheet.

Use ShowGrabber to show or hide it. You can also customize its appearance with GrabberWidth, GrabberHeight, GrabberCornerRadius, GrabberBackground, and GrabberAreaHeight to match your app’s design.

Grabber customization in .NET MAUI Bottom Sheet
Grabber customization in .NET MAUI Bottom Sheet

Control the content width

A full-width Bottom Sheet can look stretched on larger screens, such as tablets and desktops. You can adjust its content width to create a more balanced layout.

To customize the width:

  • Set ContentWidthMode to Custom.
  • Specify the desired width using BottomSheetContentWidth.

By default, ContentWidthMode is set to Full, which stretches the sheet across the available width.

Custom content width in .NET MAUI Bottom Sheet
Custom content width in .NET MAUI Bottom Sheet

Swipe without scroll conflicts

What happens when a Bottom Sheet contains a scrollable view? Users should be able to scroll through the content without accidentally dragging the entire sheet.

Swiping is enabled by default through the EnableSwiping property. To avoid gesture conflicts, set:

SwipeFromHeaderOnly="True"

This restricts drag gestures to the grabber area, allowing users to scroll through the content independently.

Swiping from the header only in .NET MAUI Bottom Sheet
Swiping from the header only in .NET MAUI Bottom Sheet

Configure modal and non-modal behavior

Not every Bottom Sheet needs to block the rest of the application. For example, payment confirmation flows often require modal interaction, while music players and utility panels may work better as non-modal overlays.

The IsModal property controls this behavior. By default, it is set to True, displaying an overlay that prevents interaction with the page underneath. Set it to False to let users continue interacting with the underlying page while the sheet remains open.

You can also set CollapseOnOverlayTap to True to collapse the sheet when users tap outside it.

Non-modal Bottom Sheet with the page behind still active
Non-modal Bottom Sheet with the page behind still active

Limit which states users can reach

Some Bottom Sheets need only a compact view, while others may need more room to display detailed content. You can control these expansion options using the State property.

The control supports four states:

  • Hidden
  • Collapsed
  • HalfExpanded
  • FullExpanded

The default state is Hidden.

To restrict the states users can access, use the AllowedState property:

  • All
  • HalfExpanded
  • FullExpanded

For example, setting AllowedState to HalfExpanded prevents users from dragging the sheet into full-screen mode.

Bottom Sheet limited to the half-expanded state
Bottom Sheet limited to the half-expanded state

Adjust the sheet height

The ideal sheet height depends on the available screen space and the content you want to display. The Bottom Sheet provides three properties to control its expansion heights:

  • FullExpandedRatio controls the percentage of screen height used in the fully expanded state.
  • HalfExpandedRatio controls the height of the half-expanded state.
  • CollapsedHeight specifies the height of the collapsed state.

The default values are:

  • FullExpandedRatio = 1
  • HalfExpandedRatio = 0.5
  • CollapsedHeight = 100
Custom full-expanded height in .NET MAUI Bottom Sheet
Custom full-expanded height in .NET MAUI Bottom Sheet

Style the sheet and apply themes

Want the Bottom Sheet to blend seamlessly with your application’s interface? You can customize its appearance using the following properties:

  • Background
  • CornerRadius
  • ContentPadding

The control also supports light and dark themes, making it easier to maintain a consistent appearance in applications that offer theme switching.

Light and dark themes in .NET MAUI Bottom Sheet
Light and dark themes in .NET MAUI Bottom Sheet

Open, close, and track state changes

You can control the Bottom Sheet programmatically in a few ways:

  • Call Show() to open it.
  • Call Close() to close it.
  • Bind the IsOpen property to control its visibility.

You can also use AnimationDuration to adjust the opening and closing animation speed. Its default value is 150 milliseconds.

Need to respond to user interactions, such as expansion changes? Handle the StateChanged event. For example, you can use it to load additional content when the sheet reaches a particular state.

Build a task-details Bottom Sheet in .NET MAUI

Now, let’s put these features into practice. We’ll build a simple task management interface where selecting a task from a list opens a Bottom Sheet with its details.

Create a project and install the package

Create a new .NET MAUI application in Visual Studio and install the Syncfusion.Maui.BottomSheet package using the NuGet Package Manager.

You can also install it from the .NET CLI:

dotnet add package Syncfusion.Maui.BottomSheet

Register Syncfusion Core

Next, register the Syncfusion Core handler in the MauiProgram.cs file:

using Syncfusion.Maui.Core.Hosting;

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder.ConfigureSyncfusionCore();
        // ...
        return builder.Build();
    }
}

Create the task model

Let’s start with a simple model for each task and a view model to hold the task list:

using System.Collections.ObjectModel;

public class TaskItem
{
    public string Title { get; set; } = string.Empty;
    public string Due { get; set; } = string.Empty;
    public string Notes { get; set; } = string.Empty;
}

public class TasksViewModel
{
    public ObservableCollection<TaskItem> Tasks { get; } = new()
    {
        new() { Title = "Review pull requests", Due = "Due: Mon, Nov 16", Notes = "Check the open pull requests and leave feedback." },
        new() { Title = "Prepare sprint demo", Due = "Due: Wed, Nov 18", Notes = "Walk through the new features and the plan for next week." },
        new() { Title = "Fix login page bug", Due = "Due: Wed, Nov 18", Notes = "Resolve the error shown after an incorrect password." }
    };
}

Add the namespace and control

First, import the Bottom Sheet namespace into your XAML page:

xmlns:bottomSheet="clr-namespace:Syncfusion.Maui.BottomSheet;assembly=Syncfusion.Maui.BottomSheet"

Next, add the SfBottomSheet control. Place the main page content inside the Content property and the view displayed in the sheet inside BottomSheetContent:

<Grid>
    <Grid.BindingContext>
        <local:TasksViewModel />
    </Grid.BindingContext>
    <bottomSheet:SfBottomSheet x:Name="bottomSheet"
                               HalfExpandedRatio="0.35"
                               CornerRadius="15,15,0,0">
        <bottomSheet:SfBottomSheet.Content>
            <CollectionView ItemsSource="{Binding Tasks}"
                            SelectionMode="Single"
                            SelectionChanged="OnTaskSelected">
                <CollectionView.ItemTemplate>
                    <DataTemplate x:DataType="local:TaskItem">
                        <VerticalStackLayout Padding="16,12">
                            <Label Text="{Binding Title}" FontSize="18" />
                            <Label Text="{Binding Due}" FontSize="14" TextColor="Gray" />
                        </VerticalStackLayout>
                    </DataTemplate>
                </CollectionView.ItemTemplate>
            </CollectionView>
        </bottomSheet:SfBottomSheet.Content>
        <bottomSheet:SfBottomSheet.BottomSheetContent>
            <VerticalStackLayout x:DataType="local:TaskItem" Padding="16" Spacing="8">
                <Label Text="{Binding Title}" FontSize="20" FontAttributes="Bold" />
                <Label Text="{Binding Due}" />
                <Label Text="{Binding Notes}" />
                <Button Text="Mark complete" Margin="0,12,0,0" />
            </VerticalStackLayout>
        </bottomSheet:SfBottomSheet.BottomSheetContent>
    </bottomSheet:SfBottomSheet>
</Grid>

Show the Bottom Sheet

Finally, handle the task selection event to display the selected task’s details:

private void OnTaskSelected(object sender, SelectionChangedEventArgs e)
{
    if (e.CurrentSelection.FirstOrDefault() is TaskItem task)
    {
        bottomSheet.BottomSheetContent.BindingContext = task;
        bottomSheet.Show();
        // Clear the selection so the same task can be tapped again.
        ((CollectionView)sender).SelectedItem = null;
    }
}

Run the application and select a task from the list. The Bottom Sheet slides up to display its details, and you can swipe it between the available states.

Integrating Bottom Sheet control in .NET MAUI app
Integrating Bottom Sheet control in .NET MAUI app

GitHub reference

Want to explore the control with a working example? Check out the Bottom Sheet demo on GitHub. For API details, configuration options, and more examples, refer to the .NET MAUI Bottom Sheet documentation.

Frequently asked questions

Which platforms does the .NET MAUI Bottom Sheet support?

The Bottom Sheet works on all supported .NET MAUI platforms: Android, iOS, macOS, and Windows.

Can I place a list or scrollable content inside the Bottom Sheet?

Yes. The Bottom Sheet can host any .NET MAUI view. Set SwipeFromHeaderOnly to True so users can start swipe gestures from the grabber area without interfering with content scrolling.

Can I stop users from expanding the sheet to full screen?

Yes. Set AllowedState to HalfExpanded. The sheet can then move between the collapsed and half-expanded states.

Can users interact with the page behind the Bottom Sheet?

Yes. Set IsModal to False to allow interaction with the underlying page. By default, the Bottom Sheet is modal and blocks that interaction.

How do I open the Bottom Sheet from a ViewModel?

Bind the IsOpen property to a Boolean property in your ViewModel. Setting it to True opens the sheet, while setting it to False closes it.

Supercharge your cross-platform apps with Syncfusion's robust .NET MAUI controls.

Conclusion

Displaying additional information without taking users away from their current page is a common requirement in cross-platform applications. Instead of building layouts, animations, gestures, and overlays from scratch, you can use the .NET MAUI Bottom Sheet to bring these capabilities together in one control.

In this article, we explored how to customize the Bottom Sheet’s appearance, manage its interaction and expansion states, and use it in a practical task management scenario. Whether you’re building filter panels, item previews, location details, or task views, the control makes it easier to present contextual information while keeping users on the same page.

Ready to explore more? Check out the Bottom Sheet documentation and demo. You can also browse the complete What’s New and Release Notes documentation to discover other features relevant to your projects.

Existing Syncfusion customers can get the latest Essential Studio version from the License and Downloads page. New users can explore the control with a 30-day free trial.

Have questions or feedback? Reach out through our support forums, feedback portal, or support portal.

Meet the Author

Karthick Mani

Karthick Mani has been a .NET developer at Syncfusion since 2019. He has experience in developing custom controls for .NET Frameworks, working with the WPF Gantt Control, and delivering high-quality products.