NEW: My new book Pro SwiftUI is out now – level up your SwiftUI skills today! >>

How to add a badge to TabView items and List rows

Paul Hudson    @twostraws   

Updated for Xcode 14.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 Essential Developer

SPONSORED From March 20th to 26th, you can join a FREE crash course for mid/senior iOS devs who want to achieve an expert level of technical and practical skills – it’s the fast track to being a complete senior developer!

Click to save your free spot now

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

Similar solutions…

Buy Pro Swift Buy Pro SwiftUI 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 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 Beyond Code

Was this page useful? Let us know!

Average rating: 3.7/5

Unknown user

You are not logged in

Log in or create account

Link copied to your pasteboard.