Skip to content
Alert popup to notify your users if they use an unsupported iOS version
Swift Ruby
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Platform license

This source code alerts your users if they use your app with an unsupported version of iOS (e.g. iOS 10.0 beta). The alert looks like this:


The AlertController shows only once for each system version (e.g. only once for iOS 10.0 beta). If you would like to change this behavior, you can do this in the checkOSVersion method by removing the NSUserDefaults if queries.


  • iOS 8.0+
  • Swift 4.0



UnsupportedOSVersionAlert is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'UnsupportedOSVersionAlert'


  1. Download and drop UnsupportedOSVersionAlert.swift from the UnsupportedOSVersionAlert folder in your project.
  2. Drop the language files from the UnsupportedOSVersionAlert folder into your project.
  3. Done!

Usage example

  • Make your AppDelegate a delegate of OSVersionCheckerDelegate
class AppDelegate: UIApplicationDelegate, OSVersionCheckerDelegate
  • Implement the delegate method in your AppDelegate
func didCheckOSVersion(supported: Bool) {
    if !supported {
        self.window?.makeKeyAndVisible() // default title and message
// "Custom Title", message: "Custom Message") // custom message
  • In your application didFinishLaunchingWithOptions, use the OSVersionChecker API to set the delegate, the earliest supported version and the latest supported version
UnsupportedOSVersionAlert.check(self, earliestSupportedVersion: "8.1", latestSupportedVersion: "9.1.3")


UnsupportedOSVersionAlert was created by Josef Moser. I am an independent software developer and co-founder of Cora Health and Cryptoradar.

Find me on: Github or Twitter


We welcome contribution to this project by opening issues or pull request.


UnsupportedOSVersionAlert is available under the MIT license. See the LICENSE file for more info. If you'd like to acknowledge the author of UnsupportedOSVersionAlert, please set a link to this GitHub page.

You can’t perform that action at this time.