NEW! Master Swift design patterns with my latest book! >>

How to add a number over your app icon using applicationIconBadgeNumber

Paul Hudson       @twostraws

Once your app has the user’s permission to do so, you can show numbers over your icon to indicate outstanding tasks, unread messages, game invites, or whatever makes sense for your app.

You do need to get their permission, though, so you should start by adding an import for the UserNotifications framework, then request permission with code like this:

UNUserNotificationCenter.current().requestAuthorization(options: .badge) { (granted, error) in
    if error != nil {
        // success!
    }
}

Once you have that permission – anywhere inside the // success! comment or at some point afterwards – you can place an integer badge of your app icon with one line of code:

UIApplication.shared.applicationIconBadgeNumber = 1

Available from iOS 2.0

Did this solution work for you? Please pass it on!

Other people are reading…

About the Swift Knowledge Base

This is part of the Swift Knowledge Base, a free, searchable collection of solutions for common iOS questions.

Become a Swift expert

I wrote a book called Pro Swift that's dedicated to helping you master the Swift language, and it includes seven hours of video demonstrating each technique!

MASTER SWIFT NOW
Buy Practical iOS 12 Buy Pro Swift Buy Swift Design Patterns Buy Practical iOS 11 Buy Swift Coding Challenges Buy Server-Side Swift (Vapor Edition) Buy Server-Side Swift (Kitura Edition) Buy Hacking with macOS Buy Advanced iOS Volume One Buy Hacking with watchOS Buy Hacking with tvOS Buy Hacking with Swift Buy Dive Into SpriteKit Buy Swift in Sixty Seconds Buy Objective-C for Swift Developers Buy Beyond Code

Was this page useful? Let me know!

Click here to visit the Hacking with Swift store >>