Expo

Documentation

Sharing

expo-sharing allows you to share files directly with other compatible applications.

Platform Compatibility

Android DeviceAndroid EmulatoriOS DeviceiOS SimulatorWeb
✅✅✅✅✅

🚨 Web browser support: expo-sharing for web is built on top of the Web Share API, which still has very limited browser support. Be sure to check that the API can be used before calling it by using Sharing.isAvailableAsync().

💡 HTTPS required on web: The Web Share API is only available on web when the page is served over https. Run your app with expo start --https to enable it.

⚠️ No local file sharing on web: Sharing local files by URI works on iOS and Android, but not on web. You cannot share local files on web by URI — you will need to upload them somewhere and share that URI.

Installation

For managed apps, you'll need to run expo install expo-sharing. To use it in a bare React Native app, follow its installation instructions.

API

import * as Sharing from 'expo-sharing';
Methods

Methods

Sharing.isAvailableAsync()

Determine if the sharing API can be used in this app.

Returns

A promise that resolves to true if the sharing API can be used, and false otherwise.

Sharing.shareAsync(url, options)

Opens action sheet to share file to different applications which can handle this type of file.

Arguments

  • url (string) -- Local file URL to share.
  • options (object) --
    A map of options:
    • mimeType (string) -- sets mimeType for Intent (Android only)
    • dialogTitle (string) -- sets share dialog title (Android and Web only)
    • UTI (string) -- (Uniform Type Identifier) the type of the target file (iOS only)