callstack / callstack/react-native-paper

Subtitle: Why was the subtitle prop deprecated in Appbar.Content when MD3 explicitly supports subtitles in app bars?

Open
#4,875 0 comments 3 reactions 0 assignees View on GitHub
question
Dominant language
TypeScript
Stars
14.5k
Forks
2.2k
Avg merge
5d 23h
Merged PRs (30d)
12

Description

Image

The subtitle and subtitleStyle props on Appbar.Content are marked as deprecated in v5.x, yet the [[Material Design 3 specification for app bars]](https://m3.material.io/components/app-bars/specs) clearly shows subtitles as a supported and documented part of the component across all app bar sizes (small, medium, and large).
As seen in the MD3 spec, all center-aligned and expanding app bar variants include a Headline + Subtitle layout.

**A few questions:**
- What was the reasoning behind deprecating the subtitle prop in the v5 / MD3 theme update?
- Is there an officially recommended alternative for rendering a subtitle under the title in Appbar.Header?
- Are there any plans to reintroduce subtitle support, perhaps tied to the mode prop (e.g., only for medium or large modes where the spec shows it)?

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.