--- description: Capacitor plugin to launch arbitrary Android intents, start activities and read their results, resolve intent handlers, and attach extras and flags. Android only. title: Capacitor Android Intent Launcher Plugin - Capawesome image: https://capawesome.io/docs/assets/images/social/sdks/capacitor/android-intent-launcher.png --- [Skip to content ](#capacitor-android-intent-launcher-plugin) [🖥️ Introducing the **Capacitor Electron Platform** — build desktop apps for macOS, Windows, and Linux. Free & open source. ](/blog/announcing-the-capacitor-electron-platform/) * [ SDKs ](/docs/sdks/) * [ Configuration ](#configuration) * [ Usage ](#usage) * [ API ](#api) * [ Type Aliases ](#type-aliases) * [ Common Intents ](#common-intents) * [ Package Visibility ](#package-visibility) * [ FAQ ](#faq) * [ Related Plugins ](#related-plugins) * [ Newsletter ](#newsletter) * [ Changelog ](#changelog) * [ License ](#license) * [ 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/) * 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 * [ Configuration ](#configuration) * [ Usage ](#usage) * [ API ](#api) * [ Type Aliases ](#type-aliases) * [ Common Intents ](#common-intents) * [ Package Visibility ](#package-visibility) * [ FAQ ](#faq) * [ Related Plugins ](#related-plugins) * [ Newsletter ](#newsletter) * [ Changelog ](#changelog) * [ License ](#license) # Capacitor Android Intent Launcher Plugin[¶](#capacitor-android-intent-launcher-plugin "Permanent link") Capacitor plugin to launch arbitrary Android intents. [ ![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") * 🚀 **Start activities**: Launch any Android activity via a custom intent and read its result. * 🔍 **Resolve activities**: Check whether an activity can handle an intent before launching it. * 🎯 **Explicit & implicit intents**: Target a specific component or let the system pick a handler. * 📦 **Extras & flags**: Attach primitive extras and intent flags. * 🔁 **Up-to-date**: Always supports the latest Capacitor version. * 🤝 **Compatibility**: Works alongside the [Settings Launcher](https://capawesome.io/docs/sdks/capacitor/settings-launcher/) and [App Launcher](https://capawesome.io/docs/sdks/capacitor/app-launcher/) plugins. 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 Android Intent Launcher plugin is typically used whenever an app needs to interact with system screens or other apps that no dedicated plugin covers, for example: * **Opening system screens**: Open Android system screens such as the app settings screen via the `android.settings.APPLICATION_DETAILS_SETTINGS` action. * **Integrating with other apps**: Launch a specific activity of another app via an explicit intent and read its result code and result data once it finishes. * **Sharing and composing**: Share plain text via the `android.intent.action.SEND` action or compose an email via the `android.intent.action.SENDTO` action. * **Feature detection**: Check whether an activity exists that can handle an intent before launching it, for example to conditionally show a button in your UI. ## 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-android-intent-launcher` 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-android-intent-launcher [](#%5F%5Fcodelineno-2-2)npx cap sync ` This plugin is only available on **Android**. On iOS and Web, all methods reject as unimplemented. ### Android[¶](#android "Permanent link") No additional configuration is required for this plugin. However, on Android 11 (API level 30) and higher, [package visibility](https://developer.android.com/training/package-visibility) restricts which apps and intents your app can see. To launch or resolve intents that target other apps, you may need to declare matching [](https://developer.android.com/guide/topics/manifest/queries-element) entries in your app's `AndroidManifest.xml`. See [Package visibility](#package-visibility) below. ### iOS[¶](#ios "Permanent link") This plugin has **no iOS implementation**. Intents are an Android-only concept. All methods reject as unimplemented on iOS. ## Configuration[¶](#configuration "Permanent link") No configuration required for this plugin. ## Usage[¶](#usage "Permanent link") The following examples show how to start an activity for an intent and check whether an intent can be resolved. ### Start an activity[¶](#start-an-activity "Permanent link") Launch an activity for the given intent. The intent is started via the `startActivityForResult(...)` API, so the result code and result data of the launched activity are returned once it finishes. Only available on Android: `[](#%5F%5Fcodelineno-3-1)import { AndroidIntentLauncher } from '@capawesome/capacitor-android-intent-launcher'; [](#%5F%5Fcodelineno-3-2) [](#%5F%5Fcodelineno-3-3)const startActivity = async () => { [](#%5F%5Fcodelineno-3-4) const { resultCode } = await AndroidIntentLauncher.startActivity({ [](#%5F%5Fcodelineno-3-5) action: 'android.intent.action.VIEW', [](#%5F%5Fcodelineno-3-6) dataUri: 'https://capawesome.io', [](#%5F%5Fcodelineno-3-7) }); [](#%5F%5Fcodelineno-3-8) return resultCode; [](#%5F%5Fcodelineno-3-9)}; ` ### Check whether an intent can be resolved[¶](#check-whether-an-intent-can-be-resolved "Permanent link") Check whether an activity exists that can handle the given intent before launching it. On Android 11 (API level 30) and higher, the result is affected by [package visibility](#package-visibility). Only available on Android: `[](#%5F%5Fcodelineno-4-1)import { AndroidIntentLauncher } from '@capawesome/capacitor-android-intent-launcher'; [](#%5F%5Fcodelineno-4-2) [](#%5F%5Fcodelineno-4-3)const canResolveActivity = async () => { [](#%5F%5Fcodelineno-4-4) const { canResolve } = await AndroidIntentLauncher.canResolveActivity({ [](#%5F%5Fcodelineno-4-5) action: 'android.intent.action.VIEW', [](#%5F%5Fcodelineno-4-6) dataUri: 'https://capawesome.io', [](#%5F%5Fcodelineno-4-7) }); [](#%5F%5Fcodelineno-4-8) return canResolve; [](#%5F%5Fcodelineno-4-9)}; ` ## API[¶](#api "Permanent link") * [canResolveActivity(...)](#canresolveactivity) * [startActivity(...)](#startactivity) * [Interfaces](#interfaces) * [Type Aliases](#type-aliases) ### canResolveActivity(...)[¶](#canresolveactivity "Permanent link") `[](#%5F%5Fcodelineno-5-1)canResolveActivity(options: CanResolveActivityOptions) => Promise ` Check whether an activity exists that can handle the given intent. This is a wrapper around the `PackageManager.resolveActivity(...)` API. On Android 11 (API level 30) and higher, the result is affected by package visibility. Your app may need to declare matching `<queries>`entries in its `AndroidManifest.xml` for the intent to be resolved. Only available on Android. | Param | Type | | ----------- | --------------------------------------------- | | **options** | [StartActivityOptions](#startactivityoptions) | **Returns:** `Promise<[CanResolveActivityResult](#canresolveactivityresult)>` **Since:** 0.1.0 --- ### startActivity(...)[¶](#startactivity "Permanent link") `[](#%5F%5Fcodelineno-6-1)startActivity(options: StartActivityOptions) => Promise ` Launch an activity for the given intent. The intent is started via the `startActivityForResult(...)` API so the result code and result data of the launched activity are returned once it finishes. This is the power-user escape hatch for system screens and app integrations that no dedicated plugin covers. Prefer a typed plugin (such as [Settings Launcher](https://capawesome.io/docs/sdks/capacitor/settings-launcher/)or [App Launcher](https://capawesome.io/docs/sdks/capacitor/app-launcher/)) where one exists. Only available on Android. | Param | Type | | ----------- | --------------------------------------------- | | **options** | [StartActivityOptions](#startactivityoptions) | **Returns:** `Promise<[StartActivityResult](#startactivityresult)>` **Since:** 0.1.0 --- ### Interfaces[¶](#interfaces "Permanent link") #### CanResolveActivityResult[¶](#canresolveactivityresult "Permanent link") | Prop | Type | Description | Since | | -------------- | ------- | ------------------------------------------------------------- | ----- | | **canResolve** | boolean | Whether or not an activity exists that can handle the intent. | 0.1.0 | #### StartActivityOptions[¶](#startactivityoptions "Permanent link") | Prop | Type | Description | Since | | | --------------- | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | ----- | | **action** | string | The action of the intent. | 0.1.0 | | | **categories** | string\[\] | The categories to add to the intent. | 0.1.0 | | | **className** | string | The fully qualified class name of the component to launch. Must be used together with the packageName property to create an explicit intent that targets a specific component. | 0.1.0 | | | **dataUri** | string | The data URI of the intent. | 0.1.0 | | | **extras** | { \[key: string\]: string \| number | boolean; } | The extras to add to the intent. Only primitive values (string, number and boolean) are supported. | 0.1.0 | | **flags** | number | The flags to add to the intent. Multiple flags can be combined using the bitwise OR operator. | 0.1.0 | | | **packageName** | string | The package name of the component to launch. If used without the className property, the intent is restricted to the given package. If used together with the className property, an explicit intent that targets a specific component is created. | 0.1.0 | | | **type** | string | The MIME type of the intent data. | 0.1.0 | | #### StartActivityResult[¶](#startactivityresult "Permanent link") | Prop | Type | Description | Since | | -------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- | | **dataUri** | string \| null | The data URI returned by the launched activity. | 0.1.0 | | **resultCode** | number | The result code returned by the launched activity. The value is \-1 if the activity finished successfully (RESULT\_OK), 0 if it was canceled (RESULT\_CANCELED) or any other custom result code set by the launched activity. | 0.1.0 | ### Type Aliases[¶](#type-aliases "Permanent link") #### CanResolveActivityOptions[¶](#canresolveactivityoptions "Permanent link") `[StartActivityOptions](#startactivityoptions)` ## Common Intents[¶](#common-intents "Permanent link") The following table lists a few common intents to get you started. See the [Android documentation](https://developer.android.com/reference/android/content/Intent) for the full list of actions, categories, extras and flags. | Use case | action | dataUri | type | extras | | ----------------- | ----------------------------------------------- | ----------------------- | ---------- | ----------------------------------------------- | | Open a website | android.intent.action.VIEW | https://capawesome.io | – | – | | Open the dialer | android.intent.action.DIAL | tel:+12025550123 | – | – | | Compose an email | android.intent.action.SENDTO | mailto:hi@example.com | – | { 'android.intent.extra.SUBJECT': 'Hi' } | | Share plain text | android.intent.action.SEND | – | text/plain | { 'android.intent.extra.TEXT': 'Hello world!' } | | Open app settings | android.settings.APPLICATION\_DETAILS\_SETTINGS | package:com.example.app | – | – | This plugin is intended as a **last resort** for system screens and app integrations that no dedicated plugin covers. Prefer a typed plugin where one exists — for example [Settings Launcher](https://capawesome.io/docs/sdks/capacitor/settings-launcher/) for system settings screens or [App Launcher](https://capawesome.io/docs/sdks/capacitor/app-launcher/) for opening URLs and other apps. ## Package Visibility[¶](#package-visibility "Permanent link") On Android 11 (API level 30) and higher, [package visibility](https://developer.android.com/training/package-visibility) limits which other apps your app can interact with. This affects both `startActivity(...)` (an unresolvable intent rejects with the error code `ACTIVITY_NOT_FOUND`) and `canResolveActivity(...)` (which returns `false` for intents your app cannot see). If you launch or resolve intents that target other apps, declare the intents you query in your app's `AndroidManifest.xml`. The plugin cannot predeclare arbitrary intents on your behalf. `[](#%5F%5Fcodelineno-7-1) [](#%5F%5Fcodelineno-7-2) [](#%5F%5Fcodelineno-7-3) [](#%5F%5Fcodelineno-7-4) [](#%5F%5Fcodelineno-7-5) [](#%5F%5Fcodelineno-7-6) [](#%5F%5Fcodelineno-7-7) [](#%5F%5Fcodelineno-7-8) ` ## 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 launches arbitrary Android intents — explicit or implicit — so you can open system screens or hand off to other apps even when no dedicated plugin covers them, and read the activity result back. You can attach primitive extras and intent flags, and resolve whether an activity can handle an intent before launching it, all through a fully typed API kept current with the latest Capacitor version. When a focused plugin already exists for your target, such as Settings Launcher or App Launcher, that is a fine choice; when you need full control over the raw intent, this plugin is built for it. ### Why does `startActivity` reject with the error code `ACTIVITY_NOT_FOUND`?[¶](#why-does-startactivity-reject-with-the-error-code-activity%5Fnot%5Ffound "Permanent link") This happens when no activity exists that can handle the given intent. On Android 11 (API level 30) and higher, this can also be caused by [package visibility](#package-visibility), which limits which other apps your app can see. In that case, declare the intents you query in your app's `AndroidManifest.xml` using `` entries. ### Does this plugin work on iOS or Web?[¶](#does-this-plugin-work-on-ios-or-web "Permanent link") No, intents are an Android-only concept, so this plugin has no iOS or Web implementation. On iOS and Web, all methods reject as unimplemented. ### When should I use this plugin instead of a dedicated plugin?[¶](#when-should-i-use-this-plugin-instead-of-a-dedicated-plugin "Permanent link") This plugin is intended as a last resort for system screens and app integrations that no dedicated plugin covers. Prefer a typed plugin where one exists, for example [Settings Launcher](https://capawesome.io/docs/sdks/capacitor/settings-launcher/) for system settings screens or [App Launcher](https://capawesome.io/docs/sdks/capacitor/app-launcher/) for opening URLs and other apps. ### Can I pass complex data as intent extras?[¶](#can-i-pass-complex-data-as-intent-extras "Permanent link") No, only primitive values (string, number and boolean) are supported as intent extras. Intent flags can be attached as well and multiple flags can be combined using the bitwise OR operator. ### How do I know whether the launched activity was successful?[¶](#how-do-i-know-whether-the-launched-activity-was-successful "Permanent link") The `startActivity(...)` method resolves with the result code returned by the launched activity once it finishes. The value is `-1` if the activity finished successfully (`RESULT_OK`), `0` if it was canceled (`RESULT_CANCELED`), or any other custom result code set by the launched activity. ### 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") * [Settings Launcher](https://capawesome.io/docs/sdks/capacitor/settings-launcher/): Open native settings screens with a typed API. * [App Launcher](https://capawesome.io/docs/sdks/capacitor/app-launcher/): Check if an app can be opened and open it. * [File Opener](https://capawesome.io/docs/sdks/capacitor/file-opener/): Open a file with the default application. ## 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/android-intent-launcher/CHANGELOG.md). ## License[¶](#license "Permanent link") See [LICENSE](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/android-intent-launcher/LICENSE). July 8, 2026 Back to top ```json {"@context": "https://schema.org", "@graph": [{"@type": "TechArticle", "@id": "https://capawesome.io/docs/sdks/capacitor/android-intent-launcher/#article", "headline": "Capacitor Android Intent Launcher Plugin", "name": "Capacitor Android Intent Launcher Plugin", "description": "Capacitor plugin to launch arbitrary Android intents, start activities and read their results, resolve intent handlers, and attach extras and flags. Android only.", "inLanguage": "en", "url": "https://capawesome.io/docs/sdks/capacitor/android-intent-launcher/", "mainEntityOfPage": "https://capawesome.io/docs/sdks/capacitor/android-intent-launcher/", "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/android-intent-launcher/#software"}}, {"@type": "SoftwareSourceCode", "@id": "https://capawesome.io/docs/sdks/capacitor/android-intent-launcher/#software", "name": "Capacitor Android Intent Launcher Plugin", "description": "Capacitor plugin to launch arbitrary Android intents, start activities and read their results, resolve intent handlers, and attach extras and flags. Android only.", "url": "https://capawesome.io/docs/sdks/capacitor/android-intent-launcher/", "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 launches arbitrary Android intents — explicit or implicit — so you can open system screens or hand off to other apps even when no dedicated plugin covers them, and read the activity result back. You can attach primitive extras and intent flags, and resolve whether an activity can handle an intent before launching it, all through a fully typed API kept current with the latest Capacitor version. When a focused plugin already exists for your target, such as Settings Launcher or App Launcher, that is a fine choice; when you need full control over the raw intent, this plugin is built for it."}}, {"@type": "Question", "name": "Why does startActivity reject with the error code ACTIVITY_NOT_FOUND?", "acceptedAnswer": {"@type": "Answer", "text": "This happens when no activity exists that can handle the given intent. On Android 11 (API level 30) and higher, this can also be caused by package visibility, which limits which other apps your app can see. In that case, declare the intents you query in your app's AndroidManifest.xml using entries."}}, {"@type": "Question", "name": "Does this plugin work on iOS or Web?", "acceptedAnswer": {"@type": "Answer", "text": "No, intents are an Android-only concept, so this plugin has no iOS or Web implementation. On iOS and Web, all methods reject as unimplemented."}}, {"@type": "Question", "name": "When should I use this plugin instead of a dedicated plugin?", "acceptedAnswer": {"@type": "Answer", "text": "This plugin is intended as a last resort for system screens and app integrations that no dedicated plugin covers. Prefer a typed plugin where one exists, for example Settings Launcher for system settings screens or App Launcher for opening URLs and other apps."}}, {"@type": "Question", "name": "Can I pass complex data as intent extras?", "acceptedAnswer": {"@type": "Answer", "text": "No, only primitive values (string, number and boolean) are supported as intent extras. Intent flags can be attached as well and multiple flags can be combined using the bitwise OR operator."}}, {"@type": "Question", "name": "How do I know whether the launched activity was successful?", "acceptedAnswer": {"@type": "Answer", "text": "The startActivity(...) method resolves with the result code returned by the launched activity once it finishes. The value is -1 if the activity finished successfully ( RESULT_OK), 0 if it was canceled ( RESULT_CANCELED), or any other custom result code set by the launched activity."}}, {"@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/android-intent-launcher/"} ```