Package detail

expo-document-picker

expo1.6mMIT14.0.8

Provides access to the system's UI for selecting documents from the available providers on the user's device.

react-native, expo, expo-document-picker, document-picker

readme

Expo

Try Expo in the Browser • Read the Documentation • Learn more on our blog • Request a feature

Follow us on

Introduction

Expo is an open-source platform for making universal native apps that run on Android, iOS, and the web. It includes a universal runtime and libraries that let you build native apps by writing React and JavaScript.

This repository includes the Expo SDK, Modules API, Go app, CLI, Router, documentation, and various other supporting tools. Expo Application Services (EAS) is a platform of hosted services that are deeply integrated with Expo open source tools. EAS helps you build, ship, and iterate on your app as an individual or a team.

Read the Expo Community Guidelines before interacting in the repository. Thank you for helping keep the Expo community open and welcoming!

📚 Documentation
🗺 Project Layout
🏅 Badges
👏 Contributing
❓ FAQ
💙 The Team
License

📚 Documentation

Learn about building and deploying universal apps in our official docs!

🗺 Project Layout

packages All the source code for Expo modules, if you want to edit a library or just see how it works this is where you'll find it.
apps This is where you can find Expo projects which are linked to the development modules. You'll do most of your testing in here.
apps/expo-go This is where you can find the source code for Expo Go.
apps/expo-go/ios/Exponent.xcworkspace is the Xcode workspace. When developing iOS, always open this instead of Exponent.xcodeproj because the workspace also loads the CocoaPods dependencies.
docs The source code for https://docs.expo.dev
templates The template projects you get when you run npx create-expo-app
react-native-lab This is our fork of react-native used to build Expo Go.
guides In-depth tutorials for advanced topics like contributing to the client.
tools contain build and configuration tools.
template-files contains templates for files that require private keys. They are populated using the keys in template-files/keys.json.
template-files/ios/dependencies.json specifies the CocoaPods dependencies of the app.

🏅 Badges

Let everyone know your app can be run instantly in the Expo Go app!

[![runs with Expo Go](https://img.shields.io/badge/Runs%20with%20Expo%20Go-000.svg?style=flat-square&logo=EXPO&labelColor=f3f3f3&logoColor=000)](https://expo.dev/client)

[![runs with Expo Go](https://img.shields.io/badge/Runs%20with%20Expo%20Go-4630EB.svg?style=flat-square&logo=EXPO&labelColor=f3f3f3&logoColor=000)](https://expo.dev/client)

👏 Contributing

If you like Expo and want to help make it better then check out our contributing guide! Check out the CLI package to work on the Expo CLI.

❓ FAQ

If you have questions about Expo and want answers, then check out our Frequently Asked Questions!

If you still have questions you can ask them on our Discord and Forums or X @expo.

💙 The Team

Curious about who makes Expo? Here are our team members!

License

The Expo source code is made available under the MIT license. Some of the dependencies are licensed differently, with the BSD license, for example.

Star the Expo repo on GitHub to support the project

changelog

Changelog

Unpublished

🛠 Breaking changes

🎉 New features

🐛 Bug fixes

💡 Others

14.0.8 — 2025-12-05

This version does not introduce any user-facing changes.

14.0.7 — 2025-09-11

This version does not introduce any user-facing changes.

14.0.6 — 2025-09-02

This version does not introduce any user-facing changes.

14.0.5 — 2025-08-31

This version does not introduce any user-facing changes.

14.0.4 — 2025-08-27

This version does not introduce any user-facing changes.

14.0.3 — 2025-08-25

This version does not introduce any user-facing changes.

14.0.2 — 2025-08-16

This version does not introduce any user-facing changes.

14.0.1 — 2025-08-15

This version does not introduce any user-facing changes.

14.0.0 — 2025-08-13

🛠 Breaking changes

[Web] getDocumentAsync() no longer returns base64 by default. The uri on web now always points to a Blob created via URL.createObjectURL(), which can be used for previews or appended to FormData for uploads. Selecting large files on web is now almost instant, since there’s no base64 conversion by default. If you still need base64, you can pass base64: true in the options. A new base64 field will then be included in the result. (#37443 by @hirbod)

🎉 New features

[iOS][Android] add lastModified for iOS and Android to align with web (#37429 by @hirbod)

💡 Others

remove use of IOUtils for stream copying (#38096 by @vonovak)

13.1.6 - 2025-06-18

🐛 Bug fixes

[Android] avoid hard crash in case of an exception (#37110 by @vonovak)

13.1.5 — 2025-04-30

This version does not introduce any user-facing changes.

13.1.4 — 2025-04-25

This version does not introduce any user-facing changes.

13.1.3 — 2025-04-21

🐛 Bug fixes

[Android] Avoid int overflow for large files (#36245 by @vonovak)

13.1.2 — 2025-04-14

This version does not introduce any user-facing changes.

13.1.1 — 2025-04-09

This version does not introduce any user-facing changes.

13.1.0 — 2025-04-04

💡 Others

[Android] Started using expo modules gradle plugin. (#34176 by @lukmccall)
[apple] Migrate remaining expo-module.config.json to unified platform syntax. (#34445 by @reichhartd)
[web] Add option to disable file reader to read base64 from file on successfull picking. (#34739 by @danilaplee)
[iOS] Fix warnings which will become errors in Swift 6. (#35288 by @behenate)
[Android] Specified Gradle project version. (#35751 by @lukmccall)

13.0.3 - 2025-02-07

🎉 New features

[iOS] Allow setting of the com.apple.developer.ubiquity-kvstore-identifier entitlement directly. (#34338 by @keith-kurak)

13.0.2 - 2025-01-10

This version does not introduce any user-facing changes.

13.0.1 — 2024-10-22

This version does not introduce any user-facing changes.

13.0.0 — 2024-10-22

🛠 Breaking changes

Bumped iOS deployment target to 15.1. (#30840 by @tsapeta)

12.0.2 - 2024-06-13

🐛 Bug fixes

[iOS] Fix video/* MIME Type not allowing to select videos with audio. (#29673 by @gabrieldonadel)

12.0.1 — 2024-04-23

This version does not introduce any user-facing changes.

12.0.0 — 2024-04-18

💡 Others

drop unused web name property. (#27437 by @EvanBacon)
Removed deprecated backward compatible Gradle settings. (#28083 by @kudo)

11.10.1 - 2023-12-19

This version does not introduce any user-facing changes.

11.10.0 — 2023-12-12

This version does not introduce any user-facing changes.

11.9.0 — 2023-11-14

🛠 Breaking changes

Bumped iOS deployment target to 13.4. (#25063 by @gabrieldonadel)
On Android bump compileSdkVersion and targetSdkVersion to 34. (#24708 by @alanjhughes)

🐛 Bug fixes

Added default mimetype (application/octet-stream) to avoid quiet failure when mimetype is null on iOS (#24764 by @OzymandiasTheGreat)

11.8.0 — 2023-10-17

🛠 Breaking changes

Dropped support for Android SDK 21 and 22. (#24201 by @behenate)

🐛 Bug fixes

[web] Fix promise never resolving when user cancels the picker. (#24838 by @behenate)

11.7.0 — 2023-09-04

🎉 New features

Added support for React Native 0.73. (#24018 by @kudo)

11.6.1 — 2023-08-02

This version does not introduce any user-facing changes.

11.6.0 — 2023-07-28

This version does not introduce any user-facing changes.

11.5.4 - 2023-07-19

🐛 Bug fixes

Fix type on DocumentPickerOptions on iOS. (#23497 by @aleqsio)

11.5.3 - 2023-07-10

💡 Others

Remove deprecated fields and warning on getDocumentAsync. (#23135 by @alanjhughes)

11.5.2 — 2023-06-28

This version does not introduce any user-facing changes.

11.5.1 — 2023-06-27

This version does not introduce any user-facing changes.

11.5.0 — 2023-06-21

🐛 Bug fixes

Fix copyToCacheDirectory on iOS. (#23102 by @aleqsio)
Fixed Android build warnings for Gradle version 8. (#22537, #22609 by @kudo)

11.4.0 — 2023-05-08

🐛 Bug fixes

Export all types from the module. (#22172 by @alanjhughes)

11.3.0 — 2023-04-14

🎉 New features

Migrated to Expo Modules API. (#20336 by @alanhughes)
Added support for picking multiple documents. (#20365 by @alanhughes)

11.2.2 - 2023-03-28

🐛 Bug fixes

Fixed cancellation type not being marked as a Record on Android. (#21588 by @alanjhughes)

11.2.1 — 2023-02-09

This version does not introduce any user-facing changes.

11.2.0 — 2023-02-03

💡 Others

On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)

11.1.0 — 2022-12-30

🎉 New features

Migrated to Expo Modules API. (#20336 by @alanhughes)

💡 Others

Avoid dependency on uuid. (#20477 by @LinusU)

11.0.1 — 2022-10-28

This version does not introduce any user-facing changes.

11.0.0 — 2022-10-25

🛠 Breaking changes

[plugin] Upgrade minimum runtime requirement to Node 14 (LTS). (#18204 by @EvanBacon)
Bumped iOS deployment target to 13.0 and deprecated support for iOS 12. (#18873 by @tsapeta)

💡 Others

[plugin] Migrate import from @expo/config-plugins to expo/config-plugins and @expo/config-types to expo/config. (#18855 by @brentvatne)
Drop @expo/config-plugins dependency in favor of peer dependency on expo. (#18595 by @EvanBacon)

10.3.0 — 2022-07-07

This version does not introduce any user-facing changes.

10.2.1 — 2022-04-25

💡 Others

[plugin] Update to use codesigning variables in entitlements. (#17158 by @EvanBacon)

10.2.0 — 2022-04-18

💡 Others

Updated @expo/config-plugins from 4.0.2 to 4.0.14 (#15621 by @EvanBacon)

⚠️ Notices

On Android bump compileSdkVersion to 31, targetSdkVersion to 31 and Java version to 11. (#16941 by @bbarthec)

10.1.3 - 2022-02-09

This version does not introduce any user-facing changes.

10.1.2 - 2022-02-01

🐛 Bug fixes

Fix Plugin with id 'maven' not found build error from Android Gradle 7. (#16080 by @kudo)
Handle nil MIME type. (#16156 by @brentvatne)
Fix incorrectly allowing multiple document selection (#20363) by @alanhughes

10.1.1 - 2022-01-26

🐛 Bug fixes

Pass iCloudContainerEnvironment to plugin. (#15774 by @wkozyra95)

10.1.0 — 2021-12-03

🎉 New features

[plugin] Added iCloudContainerEnvironment prop for setting the com.apple.developer.icloud-container-environment entitlement (#14885 by @EvanBacon)

10.0.1 — 2021-10-01

This version does not introduce any user-facing changes.

10.0.0 — 2021-09-28

🛠 Breaking changes

Dropped support for iOS 11.0 (#14383 by @cruzach)

🐛 Bug fixes

Added AndroidManifest.xml queries for intent handling. (#13388 by @EvanBacon)
Added possibility to pass mimetypes array in order to set multiple mimetypes, fix bug with default mimetype. (#13751 by @mstach60161)
Added mimetype to getDocumentAsync result. (#13702 by @mstach60161)
Fixed file uri. (#13678 by @mstach60161)
Fix building errors from use_frameworks! in Podfile. (#14523 by @kudo)

💡 Others

Migrated from @unimodules/core to expo-modules-core. (#13757 by @tsapeta)
Updated @expo/config-plugins (#14443 by @EvanBacon)

9.2.0 — 2021-06-16

🐛 Bug fixes

Enable kotlin in all modules. (#12716 by @wschurman)

💡 Others

Migrated from unimodules-file-system-interface to expo-modules-core.
Build Android code using Java 8 to fix Android instrumented test build error. (#12939 by @kudo)
Refactored uuid imports to v7 style. (#13037 by @giautm)

9.1.2 — 2021-04-13

This version does not introduce any user-facing changes.

9.1.1 — 2021-04-09

🐛 Bug fixes

Added SSR guard. (#12420 by @EvanBacon)

9.1.0 — 2021-03-10

🎉 New features

Created config plugin. (#11977 by @EvanBacon)
Updated Android build configuration to target Android 11 (added support for Android SDK 30). (#11647 by @bbarthec)

9.0.1 — 2021-01-15

This version does not introduce any user-facing changes.

9.0.0 — 2021-01-15

🛠 Breaking changes

Dropped support for iOS 10.0 (#11344 by @tsapeta)

8.4.1 — 2020-10-02

🐛 Bug fixes

Fixed UIDocumentPickerViewController being nil on iOS 14 and thus causing the hard-crash of the application. (#10327 by @bbarthec)
Fixed Promise not being fulfilled if the document picker view controller was being dismissed by gesture on iOS. (#10325 by @sjchmiela)