--- description: Practical guide to the Capacitor File Compressor API: compress images and files at native speed in Ionic and Capacitor apps. title: Exploring the Capacitor File Compressor API - Capawesome image: https://capawesome.io/docs/assets/images/social/blog/exploring-the-capacitor-file-compressor-api.png --- [ Skip to content](#exploring-the-capacitor-file-compressor-api) [ πŸ” Introducing the **Capacitor Vault** plugin β€” store secrets behind biometrics or a device passcode.](/blog/announcing-the-capacitor-vault-plugin/) * [ SDKs ](/docs/sdks/) * [ Formbricks ](/docs/sdks/capacitor/formbricks/) * [ Geocoder ](/docs/sdks/capacitor/geocoder/) * [ Google Sign-In ](/docs/sdks/capacitor/google-sign-in/) * [ Grafana Faro ](/docs/sdks/capacitor/grafana-faro/) * [ libSQL ](/docs/sdks/capacitor/libsql/) * [ Live Update ](/docs/sdks/capacitor/live-update/) * [ Managed Configurations ](/docs/sdks/capacitor/managed-configurations/) * [ Media Session ](/docs/sdks/capacitor/media-session/) * [ ML Kit ](/docs/sdks/capacitor/mlkit/) * [ Navigation Bar ](/docs/sdks/capacitor/navigation-bar/) * [ NFC ](/docs/sdks/capacitor/nfc/) * [ OAuth ](/docs/sdks/capacitor/oauth/) * [ Pedometer ](/docs/sdks/capacitor/pedometer/) * [ Photo Editor ](/docs/sdks/capacitor/photo-editor/) * [ PostHog ](/docs/sdks/capacitor/posthog/) * [ Printer ](/docs/sdks/capacitor/printer/) * [ Purchases ](/docs/sdks/capacitor/purchases/) * [ RealtimeKit ](/docs/sdks/capacitor/realtimekit/) * [ Screen Orientation ](/docs/sdks/capacitor/screen-orientation/) * [ Screenshot ](/docs/sdks/capacitor/screenshot/) * [ Secure Preferences ](/docs/sdks/capacitor/secure-preferences/) * [ Speech Recognition ](/docs/sdks/capacitor/speech-recognition/) * [ Speech Synthesis ](/docs/sdks/capacitor/speech-synthesis/) * [ Share Target ](/docs/sdks/capacitor/share-target/) * [ Square Mobile Payments ](/docs/sdks/capacitor/square-mobile-payments/) * [ SQLite ](/docs/sdks/capacitor/sqlite/) * [ Superwall ](/docs/sdks/capacitor/superwall/) * [ Torch ](/docs/sdks/capacitor/torch/) * [ Vault ](/docs/sdks/capacitor/vault/) * [ Wifi ](/docs/sdks/capacitor/wifi/) * [ Zip ](/docs/sdks/capacitor/zip/) * [ Cordova ](/docs/sdks/cordova/) * [ Cloud ](/docs/cloud/) * [ Integrations ](/docs/cloud/live-updates/integrations/) * Concepts * Reference * [ Troubleshooting ](/docs/cloud/live-updates/troubleshooting/) * [ FAQ ](/docs/cloud/live-updates/faq/) * [ Native Builds ](/docs/cloud/native-builds/) * [ Set Up Environments ](/docs/cloud/native-builds/environments/) * [ Overwrite Native Configurations ](/docs/cloud/native-builds/native-configurations/) * [ Auto-Increment Build Numbers ](/docs/cloud/native-builds/auto-incrementing-build-numbers/) * [ Configure the Web Build Script ](/docs/cloud/native-builds/web-build-script/) * [ Build from a Monorepo ](/docs/cloud/native-builds/monorepo/) * [ Use pnpm or Yarn ](/docs/cloud/native-builds/package-managers/) * [ Install Private npm Packages ](/docs/cloud/native-builds/npm-private-registry/) * [ Override the Java Version ](/docs/cloud/native-builds/override-java-version/) * [ Custom iOS Provisioning Profiles ](/docs/cloud/native-builds/custom-ios-provisioning-profiles/) * [ Build without Git ](/docs/cloud/native-builds/build-without-git/) * [ Access Git Behind a Firewall ](/docs/cloud/native-builds/firewall-access/) * [ Integrations ](/docs/cloud/native-builds/integrations/) * Reference * [ Troubleshooting ](/docs/cloud/native-builds/troubleshooting/) * [ FAQ ](/docs/cloud/native-builds/faq/) * [ App Store Publishing ](/docs/cloud/app-store-publishing/) * [ Submit a Build ](/docs/cloud/app-store-publishing/submit-a-build/) * [ Submit Automatically After a Build ](/docs/cloud/app-store-publishing/submit-automatically/) * [ Troubleshooting ](/docs/cloud/app-store-publishing/troubleshooting/) * [ FAQ ](/docs/cloud/app-store-publishing/faq/) * [ Automations ](/docs/cloud/automations/) * [ Reference ](/docs/cloud/automations/reference/) * [ Troubleshooting ](/docs/cloud/automations/troubleshooting/) * [ FAQ ](/docs/cloud/automations/faq/) * [ Assist ](/docs/cloud/assist/) * [ CLI ](/docs/cloud/cli/) * APIs and SDKs * [ Webhooks ](/docs/cloud/webhooks/) * [ Integrations ](/docs/cloud/integrations/) * Account * [ Organization ](/docs/cloud/organizations/) * [ Two-Factor Enforcement ](/docs/cloud/organizations/two-factor-authentication/) * [ Audit Logs ](/docs/cloud/organizations/audit-logs/) * [ Billing ](/docs/cloud/organizations/billing/) * [ License Keys ](/docs/cloud/license-keys/) * [ AI ](/docs/ai/) * [ Insiders ](/docs/insiders/) * [ Billing & Plans ](/docs/insiders/billing-and-plans/) * [ FAQ ](/docs/insiders/faq/) * [ License ](https://capawesome.io/legal/eula/) * [ Support ](/docs/support/) * [ Contributing ](/docs/contributing/) * Contributing code * [ Code of Conduct ](/docs/contributing/code-of-conduct/) * [ Questions ](https://docs.github.com/en/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion#creating-a-discussion) * [ Blog ](/blog/) * Categories * [ Best Practices ](#best-practices) * [ Conclusion ](#conclusion) * Related links # Exploring the Capacitor File Compressor API[ΒΆ](#exploring-the-capacitor-file-compressor-api "Permanent link") File compression is a critical feature for modern mobile applications, especially when dealing with image uploads, storage optimization, and bandwidth management. With the [Capacitor File Compressor plugin](/docs/sdks/capacitor/file-compressor/) from Capawesome, developers can seamlessly integrate powerful image compression capabilities into their Ionic and Capacitor applications, reducing file sizes while maintaining acceptable quality levels across Android, iOS, and Web platforms through a unified API that simplifies the complexity of platform-specific compression implementations. ## Installation[ΒΆ](#installation "Permanent link") To install the Capacitor File Compressor plugin, please refer to the [Installation](/docs/sdks/capacitor/file-compressor/#installation) section in the plugin documentation. ## Usage[ΒΆ](#usage "Permanent link") Let's explore the key features of the Capacitor File Compressor API and how to implement them effectively in your Ionic applications. ### Compressing Images[ΒΆ](#compressing-images "Permanent link") The primary functionality of the plugin is provided through the [compressImage(...)](/docs/sdks/capacitor/file-compressor/#compressimage) method, which handles image compression with customizable quality settings: `[](#%5F%5Fcodelineno-0-1)import { FileCompressor } from '@capawesome-team/capacitor-file-compressor'; [](#%5F%5Fcodelineno-0-2) [](#%5F%5Fcodelineno-0-3)const compressImage = async (imagePath: string) => { [](#%5F%5Fcodelineno-0-4) const { path } = await FileCompressor.compressImage({ [](#%5F%5Fcodelineno-0-5) mimeType: 'image/jpeg', [](#%5F%5Fcodelineno-0-6) path: imagePath, [](#%5F%5Fcodelineno-0-7) quality: 0.7, [](#%5F%5Fcodelineno-0-8) }); [](#%5F%5Fcodelineno-0-9) return path; [](#%5F%5Fcodelineno-0-10)}; ` The `compressImage(...)` method accepts several configuration options to control the compression process, including: * `mimeType`: The output format (image/jpeg, image/png, or image/webp) * `path`: The file path of the image to compress * `quality`: Compression quality from 0.0 (maximum compression) to 1.0 (best quality) For more aggressive compression, you can lower the quality value: `[](#%5F%5Fcodelineno-1-1)const compressImageHeavily = async (imagePath: string) => { [](#%5F%5Fcodelineno-1-2) const { path } = await FileCompressor.compressImage({ [](#%5F%5Fcodelineno-1-3) mimeType: 'image/jpeg', [](#%5F%5Fcodelineno-1-4) path: imagePath, [](#%5F%5Fcodelineno-1-5) quality: 0.3, // Higher compression, lower quality [](#%5F%5Fcodelineno-1-6) }); [](#%5F%5Fcodelineno-1-7) [](#%5F%5Fcodelineno-1-8) return path; [](#%5F%5Fcodelineno-1-9)}; ` You can also specify different output formats based on your needs. For example, converting PNG images to JPEG for better compression: `[](#%5F%5Fcodelineno-2-1)const convertAndCompress = async (pngPath: string) => { [](#%5F%5Fcodelineno-2-2) const { path } = await FileCompressor.compressImage({ [](#%5F%5Fcodelineno-2-3) mimeType: 'image/jpeg', // Convert PNG to JPEG [](#%5F%5Fcodelineno-2-4) path: pngPath, [](#%5F%5Fcodelineno-2-5) quality: 0.8, [](#%5F%5Fcodelineno-2-6) }); [](#%5F%5Fcodelineno-2-7) [](#%5F%5Fcodelineno-2-8) return path; [](#%5F%5Fcodelineno-2-9)}; ` You can also resize images while compressing them by specifying the desired height and/or width: `[](#%5F%5Fcodelineno-3-1)const compressAndResizeImage = async (imagePath: string, inputFormat: string) => { [](#%5F%5Fcodelineno-3-2) const { path } = await FileCompressor.compressImage({ [](#%5F%5Fcodelineno-3-3) height: 800, // Resize height to 800 pixels [](#%5F%5Fcodelineno-3-4) mimeType: 'image/jpeg', [](#%5F%5Fcodelineno-3-5) path: imagePath, [](#%5F%5Fcodelineno-3-6) quality: 0.7, [](#%5F%5Fcodelineno-3-7) width: 600, // Resize width to 600 pixels [](#%5F%5Fcodelineno-3-8) }); [](#%5F%5Fcodelineno-3-9) return path; [](#%5F%5Fcodelineno-3-10)}; ` ## Best Practices[ΒΆ](#best-practices "Permanent link") When implementing image compression with the Capacitor File Compressor API, consider these best practices: 1. **Choose appropriate quality levels**: Balance file size reduction with visual quality by testing different quality values for your specific use case. Generally, values between 0.6 and 0.8 provide good compression while maintaining acceptable quality for most applications. 2. **Handle compression errors gracefully**: Implement comprehensive error handling to manage scenarios where compression fails, such as unsupported file formats or corrupted images. Always provide fallback options or user feedback when compression cannot be completed. 3. **Consider format conversion strategically**: Convert PNG images to JPEG format when transparency is not required, as JPEG typically provides better compression ratios. However, preserve PNG format when working with images that require transparency or when dealing with graphics with sharp edges and solid colors. ## Conclusion[ΒΆ](#conclusion "Permanent link") The Capacitor File Compressor Plugin from Capawesome provides an efficient solution for integrating image compression into Ionic applications. By offering a unified API across multiple platforms, it enables developers to optimize file sizes and improve application performance without the complexity of platform-specific compression implementations. To stay updated with the latest updates, features, and news about the Capawesome, Capacitor, and Ionic ecosystem, subscribe to the [Capawesome newsletter](/newsletter/) and follow us on [X (formerly Twitter)](https://x.com/capawesomeio). If you have any questions or need assistance with the Capacitor File Compressor Plugin, feel free to reach out to the Capawesome team. We're here to help you implement efficient image compression in your Ionic applications. June 8, 2026 Back to top