Skip to content

Using custom TitleView in AppShell causes shell content to be covered in iOS 26 #32287

@PlatinumDCole

Description

@PlatinumDCole

When using a custom view for the Shell's TitleView on iOS 26, the title view ends up covering the content Shell is currently displaying. See the below screenshot.

Image

When in this state, the content cannot be interacted with.

This is using the base MAUI template with a slight modification to add a custom TItleView. Here's the AppShell.xaml.

<?xml version="1.0" encoding="UTF-8" ?>
<Shell
    x:Class="TitleViewIssue.AppShell"
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    xmlns:local="clr-namespace:TitleViewIssue"
    Title="TitleViewIssue">
    
    <Shell.TitleView>
<!-- 
        This label covers the entire app and isn't contained in the title view itself.
        A workaround is to either set VerticalOptions="Center" or to give it an explicit
        HeightRequest, but neither are necessary pre-iOS 26.
-->
        <Label Text="I'm a custom title"
               FontSize="20"
               HorizontalTextAlignment="Center"
               VerticalTextAlignment="Center"/>
    </Shell.TitleView>

    <ShellContent
        Title="Home"
        ContentTemplate="{DataTemplate local:MainPage}"
        Route="MainPage" />

</Shell>

This same code doesn't have this issue when built with an older MAUI iOS workload targeting iOS 18.5.

A workaround I've found is to manually specify VerticalOptions="Center" or to set HeightRequest on the view inside <Shell.TitleView>.

Attached is a sample project that reproduces the issue.

TitleViewIssue.zip

Metadata

Metadata

Labels

area-controls-shellShell Navigation, Routes, Tabs, Flyoutarea-controls-titleviewTitleViewp/0Current heighest priority issues that we are targeting for a release.platform/ioss/triagedIssue has been revieweds/verifiedVerified / Reproducible Issue ready for Engineering Triageversion/iOS-26

Type

No type

Projects

Status

Todo

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions