react-nativeLinking Native API


Linking API enables you to both send and receive links between applications. For example, opening the Phone app with number dialed in or opening the Google Maps and starting a navigation to a chosen destination. You can also utilise Linking to make your app able to respond to links opening it from other applications.

To use Linking you need to first import it from react-native

import {Linking} from 'react-native'

To open a link call openURL.

.catch(err => console.error('An error occurred ', err))

The preferred method is to check if any installed app can handle a given URL beforehand.

.then(supported => {
  if (!supported) {
    console.log('Unsupported URL: ' + url)
  } else {
    return Linking.openURL(url)
}).catch(err => console.error('An error occurred ', err))

URI Schemes

Target AppExampleReference
Web Browser
Mailmailto:[email protected]Apple
Apple Maps,-122.148386Apple
Google Mapsgeo:37.7749,-122.4194Google
iTunesSee iTunes Link MakerApple
Facebookfb://profileStack Overflow
Facetimefacetime://[email protected]Apple
iOS Calendarcalshow:514300000 [1]iPhoneDevWiki

[1] Opens the calendar at the stated number of seconds since 1. 1. 2001 (UTC?). For some reason this API is undocumented by Apple.

You can detect when your app is launched from an external URL.

componentDidMount() {
  const url = Linking.getInitialURL()
  .then((url) => {
    if (url) {
      console.log('Initial url is: ' + url)
  }).catch(err => console.error('An error occurred ', err))

To enable this on iOS Link RCTLinking to your project.

To enable this on Android, follow these steps.