This document describes several URL schemes that are supported by system apps on iOS, macOS, and watchOS 2 and later. Native iOS apps and web apps running in Safari on any platform can use these schemes to integrate with system apps and provide a more seamless experience for the user. For example, if your iOS app displays telephone numbers, you could use an appropriate URL to launch the Phone app whenever someone taps one of those numbers. Similarly, clicking an iTunes link launches the iTunes app and plays the song specified in the link. When a user clicks a link, what happens depends on the platform and the installed system apps.
Custom URL schemes provide a way to reference resources inside your app. Users tapping a custom URL in an email, for example, launch your app in a specified context. Other apps can also trigger your app to launch with specific context data; for example, a photo library app might display a specified image. The easiest way to create and share a link to an iOS, Mac app. Using the AppStore.com URL shortener, you can quickly and easily share a direct link to an app without having to launch the App Store.
This document describes those schemes that require special attributes or special formatting in order to be understood by the associated system app. As a result, this document does not describe all URL schemes supported on different Apple platforms.
At a Glance
You should read this document if you want to launch a system app from your iOS or macOS app, or from your web app running in Safari. This document contains both Cocoa Touch sample code—using the openURL:options:completionHandler:
method of the shared UIApplication
object to open URLs—and HTML samples.
Composing Items Using Mail
Use the mailto
scheme to open the Mail app and populate a new email with information.
Relevant Chapter:Mail Links
Starting a Phone or FaceTime Conversation
Use the tel
and facetime
schemes to initiate telephone or video conversations.
Specifying Text Messages
Use the sms
scheme to compose a text message and specify a recipient.
What Is Url Link
Relevant Chapter:SMS Links
Opening Locations in Maps
Use specially formatted URLs to open the Maps app and display directions or locations.
Opening Items in iTunes
Use specially formatted URLs to open iTunes and display items in the iTunes Music Store.
Relevant Chapter:iTunes Links
Opening YouTube Videos
Use specially formatted URLs to open YouTube videos in Safari.
How To Edit Hyperlink In Mac Mail
Copyright © 2017 Apple Inc. All Rights Reserved. Terms of Use | Privacy Policy | Updated: 2017-09-19