Ionic Framework 4 is almost here. Preview the beta docs and try it out now! Try Ionic 4 Beta

Image Picker

Improve this doc

Cordova Plugin For Multiple Image Selection

Requires Cordova plugin: cordova-plugin-image-picker. For more info, please see the



  1. Install the Cordova and Ionic Native plugins:
    $ ionic cordova plugin add cordova-plugin-telerik-imagepicker --variable PHOTO_LIBRARY_USAGE_DESCRIPTION="your usage message"
    $ npm install --save @ionic-native/image-picker
  2. Add this plugin to your app's module

Supported platforms


import { ImagePicker } from '@ionic-native/image-picker';

constructor(private imagePicker: ImagePicker) { }


this.imagePicker.getPictures(options).then((results) => {
  for (var i = 0; i < results.length; i++) {
      console.log('Image URI: ' + results[i]);
}, (err) => { });

Instance Members


Pick pictures from the library.

Param Type Details
options ImagePickerOptions

Returns: Promise<any> Returns a Promise that resolves the image file URI otherwise rejects with an error.



Check if we have permission to read images

Returns: Promise<boolean> Returns a promise that resolves with a boolean that indicates whether we have permission



Request permission to read images

Returns: Promise<any>


Param Type Details
maximumImagesCount number

max images to be selected, defaults to 15. If this is set to 1, upon selection of a single image, the plugin will return it. (Android only)

width number

Max width to allow images to be

height number

Max height to allow images to be

quality number

Quality of images, defaults to 100

outputType number

Choose the format of the return value. Defined in ImagePicker.OutputType. Default is FILE_URI. FILE_URI : 0, Return image file URI, DATA_URL : 1, Return image as base64-encoded string