NEW: Learn to build the incredible iOS 15 Weather app today! >>

How to add a badge to TabView items and List rows

Paul Hudson    @twostraws   

Updated for Xcode 13.2

New in iOS 15

SwiftUI’s badge() modifier lets us add numbers and text to tab view items and list rows, with the purpose of drawing the user’s attention to some supplementary status information – something like a number over a tab icon to represent an unread message count, for example.

For example, if you wanted to show the number 5 in red over a tab item, you would use this:

TabView {
    Text("Your home screen here")
        .tabItem {
            Label("Home", systemImage: "house")

Download this as an Xcode project

Some text above a blue label. The label's house icon has a circular red badge in the top right containing the number 5.

Badges work just as well with list rows, and automatically appear as right-aligned text in a secondary color. For example, we could make static list rows similar to the iOS Settings app like this:

List {
        .badge("LAN Solo")


Download this as an Xcode project

A list of two rows, containing “Wi-Fi” beside “LAN Solo”, and “Bluetooth” beside “On”.

Hacking with Swift is sponsored by Sentry

SPONSORED With Sentry’s error and performance monitoring for iOS, you see mobile vitals that actually matter, can solve any latency issues quickly, and learn how each release is performing over time.

Learn More

Sponsor Hacking with Swift and reach the world's largest Swift community!

Similar solutions…

Buy Pro Swift Buy Swift Design Patterns Buy Testing Swift Buy Hacking with iOS Buy Swift Coding Challenges Buy Swift on Sundays Volume One Buy Server-Side Swift (Vapor Edition) Buy Advanced iOS Volume One Buy Advanced iOS Volume Two Buy Advanced iOS Volume Three Buy Hacking with watchOS Buy Hacking with tvOS Buy Hacking with macOS Buy Dive Into SpriteKit Buy Swift in Sixty Seconds Buy Objective-C for Swift Developers Buy Server-Side Swift (Kitura Edition) Buy Beyond Code

Was this page useful? Let us know!

Average rating: 3.0/5

Unknown user

You are not logged in

Log in or create account

Link copied to your pasteboard.