Skip to main content
Capgo logo
← Back To Plugins

Using @capgo/capacitor-file-picker

Capacitor File Picker Plugin interface for selecting files, images, videos, and directories.

Install

bun add @capgo/capacitor-file-picker
bunx cap sync

What This Plugin Exposes

  • pickFiles - Pick one or more files from the device.
  • pickImages - Pick one or more images from the gallery. Android/iOS only.
  • pickVideos - Pick one or more videos from the gallery. Android/iOS only.
  • pickMedia - Pick one or more images or videos from the gallery. Android/iOS only.

Example Usage

pickFiles

Pick one or more files from the device.

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.pickFiles({
  types: ['application/pdf', 'image/*'],
  limit: 5,
  readData: false
});
console.log('Picked files:', result.files);

pickImages

Pick one or more images from the gallery. Android/iOS only.

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.pickImages({
  limit: 10,
  readData: false
});
console.log('Picked images:', result.files);

pickVideos

Pick one or more videos from the gallery. Android/iOS only.

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.pickVideos({
  limit: 3,
  skipTranscoding: true
});
console.log('Picked videos:', result.files);

pickMedia

Pick one or more images or videos from the gallery. Android/iOS only.

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.pickMedia({
  limit: 5,
  readData: true
});
console.log('Picked media:', result.files);

Full Reference