Expo

Documentation

DocumentPicker

Provides access to the system's UI for selecting documents from the available providers on the user's device.
Platform Compatibility
Android DeviceAndroid EmulatoriOS DeviceiOS SimulatorWeb

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

On iOS, for standalone apps and ExpoKit projects, the DocumentPicker module requires the iCloud entitlement to work properly. You need to set the usesIcloudStorage key to true in your app.json file as specified here.
In addition, you'll also need to enable the iCloud Application Service in your App identifier. This can be done in the detail of your App ID in the Apple developer interface.
Enable iCloud service with CloudKit support, create one iCloud Container, and name it iCloud.<your_bundle_identifier>.
And finally, to apply those changes, you'll need to revoke your existing provisioning profile and run expo build:ios -c
For ExpoKit apps, you need to open the project in Xcode and follow the Using DocumentPicker instructions in the Advanced ExpoKit Topics guide.

import * as DocumentPicker from 'expo-document-picker';

Display the system UI for choosing a document. By default, the chosen file is copied to the app's internal cache directory.
Note for Web: The system UI can only be shown after user activation (e.g. a Button press). Therefore, calling getDocumentAsync in componentDidMount, for example, will not work as intended.

  • options (object) --
    A map of options:
    • type (string) -- The MIME type of the documents that are available to be picked. Is also supports wildcards like image/* to choose any image. To allow any type of document you can use */*. Defaults to */*.
    • copyToCacheDirectory (boolean) -- If true, the picked file is copied to FileSystem.CacheDirectory, which allows other Expo APIs to read the file immediately. Defaults to true. This may impact performance for large files, so you should consider setting this to false if you expect users to pick particularly large files and your app does not need immediate read access.
    • multiple (boolean) -- (Web Only) Allows multiple files to be selected from the system UI. Defaults to false.

If the user cancelled the document picking, returns { type: 'cancel' }.
Otherwise, returns { type: 'success', uri, name, size } where uri is a URI to the local document file, name is its original name and size is its size in bytes.