npmpackage.info

Gathering detailed insights and metrics for react-native-image-picker

Other packages similar to react-native-image-picker

react-native-image-crop-picker

0.50.1

Select single or multiple images, with cropping option

expo-image-picker

16.1.4

Provides access to the system's UI for selecting images and videos from the phone's library or taking a photo with the camera.

react-native-syan-image-picker

0.5.3

React-Native 多图片选择支持裁剪压缩

@react-native-oh-tpl/react-native-image-picker

7.0.3-0.1.7

A React Native module that allows you to use native UI to select media from the device library or directly from the camera

Gathering detailed insights and metrics for react-native-image-picker

react-native-image-picker - 8.2.1 | npmpackage.info

react-native-image-picker

🌄 A React Native module that allows you to use native UI to select media from the device library or directly from the camera.

8.2.1

8,566

MIT

Java

184.73 kB

3.2

Installations

npm install react-native-image-picker

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS

Node Version

18.20.8

NPM Version

9.7.1 Pull Requests

Open

36

Total

545

Closed

210

Merged

299

Issues

Open

287

Total

1,690

Closed

1,403

Releases

142

v8.2.1

Updated on May 04, 2025

v8.2.0

Updated on Feb 27, 2025

v8.1.0

Updated on Feb 16, 2025

v8.0.0

Updated on Feb 01, 2025

v7.2.3

Updated on Dec 09, 2024

v7.2.2

Updated on Nov 29, 2024

View All 142 releases

Languages

Java

Objective-C++

TypeScript

Objective-C

Ruby

JavaScript

Kotlin

HTML

Java (41.49%)

Objective-C++ (27.89%)

TypeScript (18.49%)

Objective-C (3.89%)

Ruby (2.89%)

JavaScript (2.63%)

Kotlin (2.36%)

HTML (0.36%)

Developer

react-native-image-picker

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

MIT License

8,566 Stars

863 Commits

2,094 Forks

111 Watchers

5 Branches

181 Contributors

Updated on Jul 11, 2025

Maintainers

View All 181 Contributors

Package Meta Information

Latest Version

8.2.1

Package Id

react-native-image-picker@8.2.1

Unpacked Size

184.73 kB

Size

81.30 kB

File Count

NPM Version

9.7.1

Node Version

18.20.8

Published on

May 04, 2025

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

NaN

Compared to previous day

Last Week

NaN

Compared to previous week

Last Month

NaN

Compared to previous month

Last Year

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Peer Dependencies

react react-native

Dev Dependencies

@react-native-community/bob @semantic-release/git @types/react @types/react-native semantic-release typescript

react-native-image-picker 🎆

A React Native module that allows you to select a photo/video from the device library or camera.

Installation

1yarn add react-native-image-picker

New Architecture

To take advantage of the new architecture run-

iOS

1RCT_NEW_ARCH_ENABLED=1 npx pod-install ios

Android

Set newArchEnabled to true inside android/gradle.properties

Pre-Fabric (AKA not using the new architecture)

1npx pod-install ios

Post-install Steps

iOS

Add the appropriate keys to your Info.plist depending on your requirement:

Requirement	Key
Select image/video from photos	NSPhotoLibraryUsageDescription
Capture Image	NSCameraUsageDescription
Capture Video	NSCameraUsageDescription & NSMicrophoneUsageDescription

Android

No permissions required (saveToPhotos requires permission check).

Note: This library does not require Manifest.permission.CAMERA, if your app declares as using this permission in manifest then you have to obtain the permission before using launchCamera.

Targeting Android API Levels Below 30

If your app's minSdkVersion is set to below 30 and it does not already include or depend on androidx.activity:activity:1.9.+ or a newer version, you'll need to add the following line to the dependencies section of your app/build.gradle file to ensure support for the backported AndroidX Photo Picker:

1dependencies {
2    ...
3    implementation("androidx.activity:activity:1.9.+")
4    ...
5}

Additionally, you may need to update your AndroidManifest.xml to trigger the installation of the backported Photo Picker. For reference, you can check the example app's configuration in example/android/app/src/main/AndroidManifest.xml and example/android/app/build.gradle.

For more details, consult the Android documentation on AndroidX Photo Picker: https://developer.android.com/training/data-storage/shared/photopicker

API Reference

Methods

1import {launchCamera, launchImageLibrary} from 'react-native-image-picker';

`launchCamera()`

Launch camera to take photo or video.

1launchCamera(options?, callback);
2
3// You can also use as a promise without 'callback':
4const result = await launchCamera(options?);

See Options for further information on options.

The callback will be called with a response object, refer to The Response Object.

`launchImageLibrary`

Launch gallery to pick image or video.

1launchImageLibrary(options?, callback)
2
3// You can also use as a promise without 'callback':
4const result = await launchImageLibrary(options?);

See Options for further information on options.

The callback will be called with a response object, refer to The Response Object.

Options

Option	iOS	Android	Web	Description
mediaType	OK	OK	OK	`photo` or `video` or `mixed`(`launchCamera` on Android does not support 'mixed'). Web only supports 'photo' for now.
restrictMimeTypes	NO	OK	NO	Array containing the mime-types allowed to be picked. Default is empty (everything).
maxWidth	OK	OK	NO	To resize the image.
maxHeight	OK	OK	NO	To resize the image.
videoQuality	OK	OK	NO	`low`, `medium`, or `high` on iOS, `low` or `high` on Android.
durationLimit	OK	OK	NO	Video max duration (in seconds).
quality	OK	OK	NO	0 to 1, photos.
conversionQuality	NO	OK	NO	For conversion from HEIC/HEIF to JPEG, 0 to 1. Default is `0.92`
cameraType	OK	OK	NO	'back' or 'front' (May not be supported in few android devices).
includeBase64	OK	OK	OK	If `true`, creates base64 string of the image (Avoid using on large image files due to performance).
includeExtra	OK	OK	NO	If `true`, will include extra data which requires library permissions to be requested (i.e. exif data).
saveToPhotos	OK	OK	NO	(Boolean) Only for `launchCamera`, saves the image/video file captured to public photo.
selectionLimit	OK	OK	OK	Supports providing any integer value. Use `0` to allow any number of files on iOS version >= 14 & Android version >= 13. Default is `1`.
presentationStyle	OK	NO	NO	Controls how the picker is presented. `currentContext`, `pageSheet`, `fullScreen`, `formSheet`, `popover`, `overFullScreen`, `overCurrentContext`. Default is `currentContext`.
formatAsMp4	OK	NO	NO	Converts the selected video to MP4 (iOS Only).
assetRepresentationMode	OK	OK	NO	A mode that determines which representation to use if an asset contains more than one on iOS or disables HEIC/HEIF to JPEG conversion on Android if set to 'current'. Possible values: 'auto', 'current', 'compatible'. Default is 'auto'.

The Response Object

key	iOS	Android	Web	Description
didCancel	OK	OK	OK	`true` if the user cancelled the process
errorCode	OK	OK	OK	Check ErrorCode for all error codes
errorMessage	OK	OK	OK	Description of the error, use it for debug purpose only
assets	OK	OK	OK	Array of the selected media, refer to Asset Object

Asset Object

key	iOS	Android	Web	Photo/Video	Requires Permissions	Description
base64	OK	OK	OK	PHOTO ONLY	NO	The base64 string of the image (photos only)
uri	OK	OK	OK	BOTH	NO	The file uri in app specific cache storage. Except when picking video from Android gallery where you will get read only content uri, to get file uri in this case copy the file to app specific storage using any react-native library. For web it uses the base64 as uri.
originalPath	NO	OK	NO	BOTH	NO	The original file path.
width	OK	OK	OK	BOTH	NO	Asset dimensions
height	OK	OK	OK	BOTH	NO	Asset dimensions
fileSize	OK	OK	NO	BOTH	NO	The file size
type	OK	OK	NO	BOTH	NO	The file type
fileName	OK	OK	NO	BOTH	NO	The file name
duration	OK	OK	NO	VIDEO ONLY	NO	The selected video duration in seconds
bitrate	---	OK	NO	VIDEO ONLY	NO	The average bitrate (in bits/sec) of the selected video, if available. (Android only)
timestamp	OK	OK	NO	BOTH	YES	Timestamp of the asset. Only included if 'includeExtra' is true
id	OK	OK	NO	BOTH	YES	local identifier of the photo or video. On Android, this is the same as fileName

Note on file storage

Image/video captured via camera will be stored in temporary folder allowing it to be deleted any time, so don't expect it to persist. Use saveToPhotos: true (default is false) to save the file in the public photos. saveToPhotos requires WRITE_EXTERNAL_STORAGE permission on Android 28 and below (The permission has to obtained by the App manually as the library does not handle that).

For web, this doesn't work.

ErrorCode

Code	Description
camera_unavailable	Camera not available on device
permission	Permission not satisfied
others	Other errors (check errorMessage for description)

License

MIT

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

License

Determines if the project has defined a license.

8

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

5

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

1

Maintained

Determines if the project is "actively maintained".

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

3.2

/10

Last Scanned on 2025-06-30

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More