--- description: Capacitor plugin to present native action sheets with styled and destructive buttons on Android and iOS. title: Capacitor Action Sheet Plugin for Android & iOS - Capawesome image: https://capawesome.io/docs/assets/images/social/sdks/capacitor/action-sheet.png --- [Skip to content ](#capacitor-action-sheet-plugin) [πŸ“² Introducing **Build Sharing** β€” get your builds onto testers' devices with a link & QR code. No account required. ](/blog/share-mobile-app-builds-with-testers/) * [ SDKs ](/docs/sdks/) * [ iOS ](#ios) * [ Configuration ](#configuration) * [ Usage ](#usage) * [ API ](#api) * [ Enums ](#enums) * [ Migrating from @capacitor/action-sheet ](#migrating-from-capacitoraction-sheet) * [ FAQ ](#faq) * [ Related Plugins ](#related-plugins) * [ Newsletter ](#newsletter) * [ Changelog ](#changelog) * [ License ](#license) * [ Age Signals ](/docs/sdks/capacitor/age-signals/) * [ Alarm ](/docs/sdks/capacitor/alarm/) * [ Android Battery Optimization ](/docs/sdks/capacitor/android-battery-optimization/) * [ Android Dark Mode Support ](/docs/sdks/capacitor/android-dark-mode-support/) * [ Android Edge-to-Edge Support ](/docs/sdks/capacitor/android-edge-to-edge-support/) * [ Android Foreground Service ](/docs/sdks/capacitor/android-foreground-service/) * [ Android Intent Launcher ](/docs/sdks/capacitor/android-intent-launcher/) * [ Android SMS Retriever ](/docs/sdks/capacitor/android-sms-retriever/) * [ App Icon ](/docs/sdks/capacitor/app-icon/) * [ App Integrity ](/docs/sdks/capacitor/app-integrity/) * [ App Language ](/docs/sdks/capacitor/app-language/) * [ App Launcher ](/docs/sdks/capacitor/app-launcher/) * [ App Review ](/docs/sdks/capacitor/app-review/) * [ App Shortcuts ](/docs/sdks/capacitor/app-shortcuts/) * [ App Tracking Transparency ](/docs/sdks/capacitor/app-tracking-transparency/) * [ App Update ](/docs/sdks/capacitor/app-update/) * [ Apple Sign-In ](/docs/sdks/capacitor/apple-sign-in/) * [ Asset Manager ](/docs/sdks/capacitor/asset-manager/) * [ Audio Player ](/docs/sdks/capacitor/audio-player/) * [ Audio Recorder ](/docs/sdks/capacitor/audio-recorder/) * [ Audio Session ](/docs/sdks/capacitor/audio-session/) * [ Background Task ](/docs/sdks/capacitor/background-task/) * [ Badge ](/docs/sdks/capacitor/badge/) * [ Barometer ](/docs/sdks/capacitor/barometer/) * [ Battery ](/docs/sdks/capacitor/battery/) * [ Biometrics ](/docs/sdks/capacitor/biometrics/) * [ Bluetooth Low Energy ](/docs/sdks/capacitor/bluetooth-low-energy/) * [ Clipboard ](/docs/sdks/capacitor/clipboard/) * [ Cloudinary ](/docs/sdks/capacitor/cloudinary/) * [ Compass ](/docs/sdks/capacitor/compass/) * [ Contacts ](/docs/sdks/capacitor/contacts/) * [ Crisp ](/docs/sdks/capacitor/crisp/) * [ Datetime Picker ](/docs/sdks/capacitor/datetime-picker/) * [ Device Info ](/docs/sdks/capacitor/device-info/) * [ Dialog ](/docs/sdks/capacitor/dialog/) * [ Electron ](/docs/sdks/capacitor/electron/) * [ Exif ](/docs/sdks/capacitor/exif/) * [ Facebook Sign-In ](/docs/sdks/capacitor/facebook-sign-in/) * [ File Compressor ](/docs/sdks/capacitor/file-compressor/) * [ File Opener ](/docs/sdks/capacitor/file-opener/) * [ File Picker ](/docs/sdks/capacitor/file-picker/) * [ Firebase ](/docs/sdks/capacitor/firebase/) * [ 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/) * [ Gyroscope ](/docs/sdks/capacitor/gyroscope/) * [ Haptics ](/docs/sdks/capacitor/haptics/) * [ Home Indicator ](/docs/sdks/capacitor/home-indicator/) * [ In-App Browser ](/docs/sdks/capacitor/in-app-browser/) * [ Install Referrer ](/docs/sdks/capacitor/install-referrer/) * [ Intercom ](/docs/sdks/capacitor/intercom/) * [ Intune ](/docs/sdks/capacitor/intune/) * [ Keep Awake ](/docs/sdks/capacitor/keep-awake/) * [ libSQL ](/docs/sdks/capacitor/libsql/) * [ Light Sensor ](/docs/sdks/capacitor/light-sensor/) * [ Live Update ](/docs/sdks/capacitor/live-update/) * [ Localization ](/docs/sdks/capacitor/localization/) * [ Mail Composer ](/docs/sdks/capacitor/mail-composer/) * [ Managed Configurations ](/docs/sdks/capacitor/managed-configurations/) * [ Maps Launcher ](/docs/sdks/capacitor/maps-launcher/) * [ Media Session ](/docs/sdks/capacitor/media-session/) * [ ML Kit ](/docs/sdks/capacitor/mlkit/) * [ Navigation Bar ](/docs/sdks/capacitor/navigation-bar/) * [ Network ](/docs/sdks/capacitor/network/) * [ NFC ](/docs/sdks/capacitor/nfc/) * [ Node.js ](/docs/sdks/capacitor/nodejs/) * [ OAuth ](/docs/sdks/capacitor/oauth/) * [ Passkeys ](/docs/sdks/capacitor/passkeys/) * [ Password Autofill ](/docs/sdks/capacitor/password-autofill/) * [ PDF Generator ](/docs/sdks/capacitor/pdf-generator/) * [ PDF Viewer ](/docs/sdks/capacitor/pdf-viewer/) * [ Pedometer ](/docs/sdks/capacitor/pedometer/) * [ Permissions ](/docs/sdks/capacitor/permissions/) * [ Phone Dialer ](/docs/sdks/capacitor/phone-dialer/) * [ Photo Editor ](/docs/sdks/capacitor/photo-editor/) * [ Photo Manipulator ](/docs/sdks/capacitor/photo-manipulator/) * [ PixLive ](/docs/sdks/capacitor/pixlive/) * [ PostHog ](/docs/sdks/capacitor/posthog/) * [ Printer ](/docs/sdks/capacitor/printer/) * [ Privacy Screen ](/docs/sdks/capacitor/privacy-screen/) * [ Proximity Sensor ](/docs/sdks/capacitor/proximity-sensor/) * [ Purchases ](/docs/sdks/capacitor/purchases/) * [ RealtimeKit ](/docs/sdks/capacitor/realtimekit/) * [ Root Detection ](/docs/sdks/capacitor/root-detection/) * [ Screen Brightness ](/docs/sdks/capacitor/screen-brightness/) * [ Screen Orientation ](/docs/sdks/capacitor/screen-orientation/) * [ Screen Reader ](/docs/sdks/capacitor/screen-reader/) * [ Screenshot ](/docs/sdks/capacitor/screenshot/) * [ Secure Preferences ](/docs/sdks/capacitor/secure-preferences/) * [ Settings Launcher ](/docs/sdks/capacitor/settings-launcher/) * [ Shake ](/docs/sdks/capacitor/shake/) * [ Silent Mode ](/docs/sdks/capacitor/silent-mode/) * [ SIM ](/docs/sdks/capacitor/sim/) * [ SMS Composer ](/docs/sdks/capacitor/sms-composer/) * [ 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/) * [ System WebView ](/docs/sdks/capacitor/system-webview/) * [ Tauri ](/docs/sdks/capacitor/tauri/) * [ Text Interaction ](/docs/sdks/capacitor/text-interaction/) * [ Text Zoom ](/docs/sdks/capacitor/text-zoom/) * [ Thermal State ](/docs/sdks/capacitor/thermal-state/) * [ Toast ](/docs/sdks/capacitor/toast/) * [ Torch ](/docs/sdks/capacitor/torch/) * [ Vault ](/docs/sdks/capacitor/vault/) * [ Volume ](/docs/sdks/capacitor/volume/) * [ Wallet ](/docs/sdks/capacitor/wallet/) * [ Wifi ](/docs/sdks/capacitor/wifi/) * [ YouTube Player ](/docs/sdks/capacitor/youtube-player/) * [ 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, Yarn, or bun ](/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/) * Notifications * 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 * [ iOS ](#ios) * [ Configuration ](#configuration) * [ Usage ](#usage) * [ API ](#api) * [ Enums ](#enums) * [ Migrating from @capacitor/action-sheet ](#migrating-from-capacitoraction-sheet) * [ FAQ ](#faq) * [ Related Plugins ](#related-plugins) * [ Newsletter ](#newsletter) * [ Changelog ](#changelog) * [ License ](#license) # Capacitor Action Sheet Plugin[ΒΆ](#capacitor-action-sheet-plugin "Permanent link") Capacitor plugin for native action sheets. [ ![Deliver Live Updates to your Capacitor app with Capawesome Cloud](../../../assets/external/cloud.capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.69628c3f.png) ](https://cloud.capawesome.io/) ## Features[ΒΆ](#features "Permanent link") * πŸ“‹ **Action Sheet**: Present a native action sheet with a list of buttons. * 🎨 **Button Styles**: Highlight destructive actions and pin a cancel button. * πŸ“ **Title & Message**: Show a title and message on both Android and iOS. * πŸ“± **iPad Ready**: Automatically anchored as a popover on iPad. * πŸ”’ **App Store safe**: Uses only official platform APIs. * 🀝 **Compatibility**: Works alongside the [Dialog](https://capawesome.io/docs/sdks/capacitor/dialog/) plugin. * πŸ“¦ **CocoaPods & SPM**: Supports CocoaPods and Swift Package Manager for iOS. * πŸ” **Up-to-date**: Always supports the latest Capacitor version. Missing a feature? Just [open an issue](https://github.com/capawesome-team/capacitor-plugins/issues) and we'll take a look! ## Use Cases[ΒΆ](#use-cases "Permanent link") The Action Sheet plugin is typically used to let the user choose between several actions in a native way, for example: * **Contextual item actions**: Show options such as upload, share, or delete when the user taps an item in a list. * **Destructive confirmations**: Highlight irreversible actions like deleting a photo using the destructive button style. * **Photo source selection**: Ask the user whether to take a new photo or pick an existing one before opening the camera. * **Cancelable flows**: Pin a cancel button to the sheet so the user can always back out of an action. ## Compatibility[ΒΆ](#compatibility "Permanent link") | Plugin Version | Capacitor Version | Status | | -------------- | ----------------- | -------------- | | 0.x.x | \>=8.x.x | Active support | ## Installation[ΒΆ](#installation "Permanent link") You can use our **AI-Assisted Setup** to install the plugin. Add the [Capawesome Skills](https://github.com/capawesome-team/skills) to your AI tool using the following command: `[](#%5F%5Fcodelineno-0-1)npx skills add capawesome-team/skills --skill capacitor-plugins ` Then use the following prompt: `` [](#%5F%5Fcodelineno-1-1) Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome/capacitor-action-sheet` plugin in my project. `` If you prefer **Manual Setup**, install the plugin by running the following commands and follow the platform-specific instructions below: `[](#%5F%5Fcodelineno-2-1)npm install @capawesome/capacitor-action-sheet [](#%5F%5Fcodelineno-2-2)npx cap sync ` ### Android[ΒΆ](#android "Permanent link") #### Variables[ΒΆ](#variables "Permanent link") This plugin will use the following project variables (defined in your app's `variables.gradle` file): * `$androidxMaterialVersion` version of `com.google.android.material:material` (default: `1.12.0`) ### iOS[ΒΆ](#ios "Permanent link") No additional configuration is required for this plugin. ## Configuration[ΒΆ](#configuration "Permanent link") No configuration required for this plugin. ## Usage[ΒΆ](#usage "Permanent link") The following example shows how to present a native action sheet and read the selected button. ### Show an action sheet[ΒΆ](#show-an-action-sheet "Permanent link") Present a native action sheet with a title, a message, and a list of buttons. Use `ActionSheetButtonStyle.Destructive` to highlight irreversible actions and `ActionSheetButtonStyle.Cancel` to pin a cancel button. The result contains the zero-based index of the selected button and whether the sheet was canceled. Only available on Android and iOS: `[](#%5F%5Fcodelineno-3-1)import { ActionSheet, ActionSheetButtonStyle } from '@capawesome/capacitor-action-sheet'; [](#%5F%5Fcodelineno-3-2) [](#%5F%5Fcodelineno-3-3)const showActions = async () => { [](#%5F%5Fcodelineno-3-4) const { index, canceled } = await ActionSheet.showActions({ [](#%5F%5Fcodelineno-3-5) title: 'Photo Options', [](#%5F%5Fcodelineno-3-6) message: 'Select an option to perform.', [](#%5F%5Fcodelineno-3-7) options: [ [](#%5F%5Fcodelineno-3-8) { title: 'Upload' }, [](#%5F%5Fcodelineno-3-9) { title: 'Share' }, [](#%5F%5Fcodelineno-3-10) { title: 'Delete', style: ActionSheetButtonStyle.Destructive }, [](#%5F%5Fcodelineno-3-11) { title: 'Cancel', style: ActionSheetButtonStyle.Cancel }, [](#%5F%5Fcodelineno-3-12) ], [](#%5F%5Fcodelineno-3-13) }); [](#%5F%5Fcodelineno-3-14) console.log('Index:', index, 'Canceled:', canceled); [](#%5F%5Fcodelineno-3-15)}; ` ## API[ΒΆ](#api "Permanent link") * [showActions(...)](#showactions) * [Interfaces](#interfaces) * [Enums](#enums) ### showActions(...)[ΒΆ](#showactions "Permanent link") `[](#%5F%5Fcodelineno-4-1)showActions(options: ShowActionsOptions) => Promise ` Show an action sheet with a list of buttons. Only available on Android and iOS. | Param | Type | | ----------- | ----------------------------------------- | | **options** | [ShowActionsOptions](#showactionsoptions) | **Returns:** `Promise<[ShowActionsResult](#showactionsresult)>` **Since:** 0.1.0 --- ### Interfaces[ΒΆ](#interfaces "Permanent link") #### ShowActionsResult[ΒΆ](#showactionsresult "Permanent link") | Prop | Type | Description | Since | | ------------ | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ----- | | **canceled** | boolean | Whether the action sheet was canceled by selecting a cancel button or by dismissing the action sheet. | 0.1.0 | | **index** | number | The index of the selected button in the options array (zero-based). If the action sheet was canceled without a cancel button, the index is \-1. | 0.1.0 | #### ShowActionsOptions[ΒΆ](#showactionsoptions "Permanent link") | Prop | Type | Description | Default | Since | | -------------- | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | ----- | | **cancelable** | boolean | Whether the action sheet can be dismissed by tapping outside of it or pressing the back button (Android). On iOS, the action sheet can always be dismissed by tapping outside of it (a system behavior). | true | 0.1.0 | | **message** | string | The message to display below the title. | | 0.1.0 | | **options** | ActionSheetButton\[\] | The buttons to display in the action sheet. | | 0.1.0 | | **title** | string | The title of the action sheet. | | 0.1.0 | #### ActionSheetButton[ΒΆ](#actionsheetbutton "Permanent link") | Prop | Type | Description | Default | Since | | --------- | ------------------------------------------------- | ------------------------ | ------------------------------ | ----- | | **style** | [ActionSheetButtonStyle](#actionsheetbuttonstyle) | The style of the button. | ActionSheetButtonStyle.Default | 0.1.0 | | **title** | string | The title of the button. | | 0.1.0 | ### Enums[ΒΆ](#enums "Permanent link") #### ActionSheetButtonStyle[ΒΆ](#actionsheetbuttonstyle "Permanent link") | Members | Value | Description | Since | | --------------- | ------------- | ------------------------------------------------------------------------------------------ | ----- | | **Cancel** | 'CANCEL' | A button that cancels the action sheet. It should be the last button in the options array. | 0.1.0 | | **Default** | 'DEFAULT' | A button with the default style. | 0.1.0 | | **Destructive** | 'DESTRUCTIVE' | A button that indicates a destructive action. | 0.1.0 | ## Migrating from `@capacitor/action-sheet`[ΒΆ](#migrating-from-capacitoraction-sheet "Permanent link") This plugin is API-compatible with the official [@capacitor/action-sheet](https://github.com/ionic-team/capacitor-plugins/tree/main/action-sheet) plugin. The `ActionSheetButtonStyle` enum uses the same values (`DEFAULT`, `DESTRUCTIVE`, `CANCEL`), so no enum changes are required. The following differences apply: | @capacitor/action-sheet | @capawesome/capacitor-action-sheet | | -------------------------------------------- | ---------------------------------------------------- | | showActions({ title, message, options }) | showActions({ title, message, options, cancelable }) | | showActions(...) β†’ { index } | showActions(...) β†’ { index, canceled } | | message and button styles ignored on Android | message and button styles rendered on Android | | cancelable not available | cancelable (default true) | ## FAQ[ΒΆ](#faq "Permanent link") ### How is this plugin different from other similar plugins?[ΒΆ](#how-is-this-plugin-different-from-other-similar-plugins "Permanent link") It presents the platform's own native action sheet on Android and iOS through a fully typed API, rendering the title, message, and button styles β€” including destructive and cancel styles β€” consistently on both platforms, and automatically anchoring as a popover on iPad. The result reports the selected button index along with a `canceled` flag, and the `cancelable` option controls dismissal, all using only official platform APIs. Actively maintained against the latest Capacitor version, it lets a single dependency cover the whole action-sheet story. ### On which platforms can I show an action sheet?[ΒΆ](#on-which-platforms-can-i-show-an-action-sheet "Permanent link") The `showActions(...)` method is only available on Android and iOS, where it presents the native action sheet of the respective platform. On iPad, the action sheet is automatically anchored as a popover. ### How do I know which button the user selected?[ΒΆ](#how-do-i-know-which-button-the-user-selected "Permanent link") The result of `showActions(...)` contains the zero-based `index` of the selected button in the `options` array and a `canceled` flag. If the action sheet was canceled without a cancel button, the index is `-1`. ### Can the user dismiss the action sheet without selecting a button?[ΒΆ](#can-the-user-dismiss-the-action-sheet-without-selecting-a-button "Permanent link") Yes. On Android, the action sheet can be dismissed by tapping outside of it or pressing the back button unless you set the `cancelable` option to `false`. On iOS, the action sheet can always be dismissed by tapping outside of it, which is a system behavior. ### How is this plugin different from the official Capacitor Action Sheet plugin?[ΒΆ](#how-is-this-plugin-different-from-the-official-capacitor-action-sheet-plugin "Permanent link") This plugin is API-compatible with the official `@capacitor/action-sheet` plugin and uses the same `ActionSheetButtonStyle` enum values. In addition, it renders the message and button styles on Android, returns a `canceled` flag, and supports the `cancelable` option. See the [migration section](#migrating-from-capacitoraction-sheet) for a detailed comparison. ### Can I use this plugin together with the Capawesome Dialog plugin?[ΒΆ](#can-i-use-this-plugin-together-with-the-capawesome-dialog-plugin "Permanent link") Yes, the plugin is designed to work alongside the [Dialog](https://capawesome.io/docs/sdks/capacitor/dialog/) plugin. Use an action sheet when the user has to choose between several actions, and a dialog for alerts, confirmations, and text input. ### Can I use this plugin with Ionic, React, Vue or Angular?[ΒΆ](#can-i-use-this-plugin-with-ionic-react-vue-or-angular "Permanent link") Yes, the plugin is framework-agnostic. It works in any Capacitor app regardless of the web framework, including Ionic with Angular, React, or Vue, as well as plain JavaScript projects. ## Related Plugins[ΒΆ](#related-plugins "Permanent link") * [Dialog](https://capawesome.io/docs/sdks/capacitor/dialog/): Display native alert, confirm, and prompt dialogs. * [Haptics](https://capawesome.io/docs/sdks/capacitor/haptics/): Provide haptic feedback such as impacts, notifications, and vibrations. * [Toast](https://capawesome.io/docs/sdks/capacitor/toast/): Show native toast notifications. ## Newsletter[ΒΆ](#newsletter "Permanent link") Stay up to date with the latest news and updates about the Capawesome, Capacitor, and Ionic ecosystem by subscribing to our [Capawesome Newsletter](https://cloud.capawesome.io/newsletter/). ## Changelog[ΒΆ](#changelog "Permanent link") See [CHANGELOG.md](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/action-sheet/CHANGELOG.md). ## License[ΒΆ](#license "Permanent link") See [LICENSE](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/action-sheet/LICENSE). July 8, 2026 Back to top ```json {"@context": "https://schema.org", "@graph": [{"@type": "TechArticle", "@id": "https://capawesome.io/docs/sdks/capacitor/action-sheet/#article", "headline": "Capacitor Action Sheet Plugin for Android & iOS", "name": "Capacitor Action Sheet Plugin for Android & iOS", "description": "Capacitor plugin to present native action sheets with styled and destructive buttons on Android and iOS.", "inLanguage": "en", "url": "https://capawesome.io/docs/sdks/capacitor/action-sheet/", "mainEntityOfPage": "https://capawesome.io/docs/sdks/capacitor/action-sheet/", "author": {"@type": "Organization", "name": "Capawesome", "url": "https://capawesome.io", "logo": {"@type": "ImageObject", "url": "https://capawesome.io/assets/images/logo.svg"}}, "publisher": {"@type": "Organization", "name": "Capawesome", "url": "https://capawesome.io", "logo": {"@type": "ImageObject", "url": "https://capawesome.io/assets/images/logo.svg"}}, "about": {"@id": "https://capawesome.io/docs/sdks/capacitor/action-sheet/#software"}}, {"@type": "SoftwareSourceCode", "@id": "https://capawesome.io/docs/sdks/capacitor/action-sheet/#software", "name": "Capacitor Action Sheet Plugin for Android & iOS", "description": "Capacitor plugin to present native action sheets with styled and destructive buttons on Android and iOS.", "url": "https://capawesome.io/docs/sdks/capacitor/action-sheet/", "programmingLanguage": "TypeScript", "runtimePlatform": "Capacitor", "codeRepository": "https://github.com/capawesome-team", "author": {"@type": "Organization", "name": "Capawesome", "url": "https://capawesome.io", "logo": {"@type": "ImageObject", "url": "https://capawesome.io/assets/images/logo.svg"}}, "publisher": {"@type": "Organization", "name": "Capawesome", "url": "https://capawesome.io", "logo": {"@type": "ImageObject", "url": "https://capawesome.io/assets/images/logo.svg"}}}]} {"@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [{"@type": "Question", "name": "How is this plugin different from other similar plugins?", "acceptedAnswer": {"@type": "Answer", "text": "It presents the platform's own native action sheet on Android and iOS through a fully typed API, rendering the title, message, and button styles β€” including destructive and cancel styles β€” consistently on both platforms, and automatically anchoring as a popover on iPad. The result reports the selected button index along with a canceled flag, and the cancelable option controls dismissal, all using only official platform APIs. Actively maintained against the latest Capacitor version, it lets a single dependency cover the whole action-sheet story."}}, {"@type": "Question", "name": "On which platforms can I show an action sheet?", "acceptedAnswer": {"@type": "Answer", "text": "The showActions(...) method is only available on Android and iOS, where it presents the native action sheet of the respective platform. On iPad, the action sheet is automatically anchored as a popover."}}, {"@type": "Question", "name": "How do I know which button the user selected?", "acceptedAnswer": {"@type": "Answer", "text": "The result of showActions(...) contains the zero-based index of the selected button in the options array and a canceled flag. If the action sheet was canceled without a cancel button, the index is -1."}}, {"@type": "Question", "name": "Can the user dismiss the action sheet without selecting a button?", "acceptedAnswer": {"@type": "Answer", "text": "Yes. On Android, the action sheet can be dismissed by tapping outside of it or pressing the back button unless you set the cancelable option to false. On iOS, the action sheet can always be dismissed by tapping outside of it, which is a system behavior."}}, {"@type": "Question", "name": "How is this plugin different from the official Capacitor Action Sheet plugin?", "acceptedAnswer": {"@type": "Answer", "text": "This plugin is API-compatible with the official @capacitor/action-sheet plugin and uses the same ActionSheetButtonStyle enum values. In addition, it renders the message and button styles on Android, returns a canceled flag, and supports the cancelable option. See the migration section for a detailed comparison."}}, {"@type": "Question", "name": "Can I use this plugin together with the Capawesome Dialog plugin?", "acceptedAnswer": {"@type": "Answer", "text": "Yes, the plugin is designed to work alongside the Dialog plugin. Use an action sheet when the user has to choose between several actions, and a dialog for alerts, confirmations, and text input."}}, {"@type": "Question", "name": "Can I use this plugin with Ionic, React, Vue or Angular?", "acceptedAnswer": {"@type": "Answer", "text": "Yes, the plugin is framework-agnostic. It works in any Capacitor app regardless of the web framework, including Ionic with Angular, React, or Vue, as well as plain JavaScript projects."}}], "url": "https://capawesome.io/docs/sdks/capacitor/action-sheet/"} ```