NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #161 most downloaded on pub.dev
Flutter plugin for selecting images from the Android and iOS image library, and taking new pictures with the camera.
Last release 2 days ago
06 Oct 2026
Release timing varies
gaps range from 3 weeks to 1.2 years
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
181 releases · first in 2017
[image_picker] Document that retrieving lost data is a one-time opera…
[image_picker] Document that retrieving lost data is a one-time opera…
retrieveLostData is a one-time operation that clears the
stored lost data once it is returned.Fixes pickMultiImage(limit: 1) and pickMultipleMedia(limit: 1) throwing an ArgumentError by delegating to single-item pickers when limit is exactly 1,
pickMultiImage(limit: 1) and pickMultipleMedia(limit: 1) throwing an ArgumentError by delegating to
single-item pickers when limit is exactly 1, since the platform interface requires limit >= 2 for multi-selection.One column per quarter.
Clarifies that maxDuration only applies to video recording and not gallery selection.
maxDuration only applies to video recording and not gallery selection.Fixes README description of plugin suggesting that only Android and iOS is supported.
Adds pickMultiVideo to allow selecting multiple videos from the gallery.
pickMultiVideo to allow selecting multiple videos from the gallery.Adds comment for the limit parameter.
Updates documentation to note that Android Photo Picker use is not optional on Android 13+.
Adds limit parameter to MediaOptions and MultiImagePickerOptions which limits the number of media that can be selected.
MediaOptions and MultiImagePickerOptions which limits
the number of media that can be selected.
Updates minimum supported SDK version to Flutter 3.13/Dart 3.1.
Updates minimum required plugin_platform_interface version to 2.1.7.
* Fixes new lint warnings.
Updates example app to use non-deprecated video_player method.
Updates README to fix broken link.
Adds pub topics to package metadata.
Adds compatibility with image_picker_for_web 3.0.
image_picker_for_web 3.0.Rolls platform implementations to ensure that pickMedia and pickMultipleMedia have platform implementations.
pickMedia and
pickMultipleMedia have platform implementations.BREAKING CHANGE: Removes the deprecated get* methods. Clients who have not already done so will need to migrate to the pick* versions that use XFile r…
get* methods. Clients who have
not already done so will need to migrate to the pick* versions that use
XFile rather than PickedFile for return values.
image_picker to consider using a constraint of
'>=0.8.9 <2.0.0' rather than ^1.0.0 when updating dependencies, to
avoid conflicts with packages that have not yet updated.Adds pickMedia and pickMultipleMedia methods.
pickMedia and pickMultipleMedia methods.Adds initial support for Windows, macOS, and Linux.
supportsImageSource to allow runtime checks for whether a given source
is supported by the current platform's implementation.Adds usePhotoPickerAndroid options.
usePhotoPickerAndroid options.Updates README to use code excerpts.
Updates minimum Flutter version to 3.3.
image_picker_for_web.Adds handling of unsupported image types to the example.
Updates README to mention usage of launchMode: singleInstance for Android.
launchMode: singleInstance for Android.Fixes BuildContext handling in example.
BuildContext handling in example.Updates minimum Flutter version to 2.10.
requestFullMetadata option to pickImage, so images on iOS can be picked without Photo Library Usage permission.Updates code for stricter lint checks.
Updates NSPhotoLibraryUsageDescription description in README.
NSPhotoLibraryUsageDescription description in README.Updates links for the merge of flutter/plugins into flutter/packages.
Updates iOS minimum version in README.
Moves Android and iOS implementations to federated packages.
Fixes library_private_types_in_public_api, sort_child_properties_last and use_key_in_widget_constructors lint warnings.
Minor fixes for new analysis options.
Adds argument error assertions to the app-facing package, to ensure consistency across platform implementations.
Update ImagePickerCache to cache multiple files.
ImagePickerCache to cache multiple files.Fix README Example for ImagePickerCache to cache multiple files.
ImagePickerCache to cache multiple files.Update minimum Flutter SDK to 2.5 and iOS deployment target to 9.0.
Suppress a unchecked cast build warning.
* Fix typos in README.md.
Improves the documentation on handling MainActivity being killed by the Android OS.
Fixes minor type issues in iOS implementation.
Refactors unit test to expose private interface via a separate test header instead of the inline declaration.
Configures the UIImagePicker to default to gallery instead of camera when picking multiple images on pre-iOS 14 devices.
UIImagePicker to default to gallery instead of camera when
picking multiple images on pre-iOS 14 devices.Internal code cleanup for stricter analysis options.
iOS: allows picking images with WebP format.
* Fixes Activity leak.
Move ImagePickerFromLimitedGalleryUITests to RunnerUITests target.
ImagePickerFromLimitedGalleryUITests to RunnerUITests target.* Fixed README Example.
Fix using Camera as image source on Android 11+
Fix pickImage not returning a value on iOS when dismissing PHPicker sheet by swiping.
Deprecate methods that return PickedFile instances:
package:cross_file XFile instances. Docs.PickedFile instances:
getImage: use pickImage instead.getVideo: use pickVideo instead.getMultiImage: use pickMultiImage instead.getLostData: use retrieveLostData instead.Add a new method getMultiImage to allow picking multiple images on iOS 14 or higher and Android 4.3 or higher. Returns only 1 image for lower versions
getMultiImage to allow picking multiple images on iOS 14 or higher
and Android 4.3 or higher. Returns only 1 image for lower versions of iOS and Android.getLostData will only get the last picked image when picking multiple images,
see: #84634.Expose errors thrown in pickImage and pickVideo docs.
pickImage and pickVideo docs.Update the example app to support the multi-image feature.
Fix image picker causing a crash when the cache directory is deleted.
Fixes an issue where preferredCameraDevice option is not working for getVideo method.
preferredCameraDevice option is not working for getVideo method.BREAKING CHANGE: Changed storage location for captured images and videos to internal cache on Android, to comply with new Google Play storage requirem…
Removed redundant request for camera permissions.
Fix a rotation problem where when camera is chosen as a source and additional parameters are added.
Readded request for camera permissions.
Your coding agent can read these notes before it upgrades. Set up the MCP server →