--- description: Capacitor plugin to open the native SMS composer prefilled with recipients and a message body on Android and iOS. title: Capacitor SMS Composer Plugin for Android & iOS - Capawesome image: https://capawesome.io/docs/assets/images/social/sdks/capacitor/sms-composer.png --- [Skip to content ](#capacitor-sms-composer-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/) * [ 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 [ SMS Composer ](/docs/sdks/capacitor/sms-composer/) * [ Configuration ](#configuration) * [ Usage ](#usage) * [ API ](#api) * [ Type Aliases ](#type-aliases) * [ Result Status ](#result-status) * [ Multiple Recipients ](#multiple-recipients) * [ FAQ ](#faq) * [ Related Plugins ](#related-plugins) * [ Newsletter ](#newsletter) * [ Changelog ](#changelog) * [ License ](#license) * [ 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 * [ Configuration ](#configuration) * [ Usage ](#usage) * [ API ](#api) * [ Type Aliases ](#type-aliases) * [ Result Status ](#result-status) * [ Multiple Recipients ](#multiple-recipients) * [ FAQ ](#faq) * [ Related Plugins ](#related-plugins) * [ Newsletter ](#newsletter) * [ Changelog ](#changelog) * [ License ](#license) # Capacitor SMS Composer Plugin[ΒΆ](#capacitor-sms-composer-plugin "Permanent link") Capacitor plugin to open the native SMS composer prefilled with recipients and a message body. [ ![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") * βœ‰οΈ **Compose**: Open the native SMS composer prefilled with recipients and a message body. * βœ… **Capability check**: Check whether the device is able to compose and send SMS messages. * πŸ”’ **Privacy-friendly**: The user always reviews and sends the message. The plugin never sends SMS on its own. * 🀝 **Compatibility**: Works alongside the [Android SMS Retriever](https://capawesome.io/docs/sdks/capacitor/android-sms-retriever/), [Contacts](https://capawesome.io/docs/sdks/capacitor/contacts/) and [Mail Composer](https://capawesome.io/docs/sdks/capacitor/mail-composer/) plugins. * πŸ“¦ **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 SMS Composer plugin is typically used whenever an app wants to hand off a prefilled text message to the user, for example: * **Invite friends**: Prefill an invitation message with a download link that users can send to their contacts. * **Share content**: Let users share an article, a product, or a coupon code via text message. * **Contact support**: Open the composer prefilled with your support phone number and a message template. * **Feature detection**: Hide SMS-related features on devices without SMS capability, such as Wi-Fi-only tablets, using `canComposeSms`. ## 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-sms-composer` 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-sms-composer [](#%5F%5Fcodelineno-2-2)npx cap sync ` This plugin is only available on **Android** and **iOS**. On Web, all methods reject as unimplemented. ### Android[ΒΆ](#android "Permanent link") No additional configuration is required. The plugin declares the necessary `` element for the `smsto` scheme in its `AndroidManifest.xml`, so the SMS capability can be detected on Android 11 (API level 30) and higher. ## Configuration[ΒΆ](#configuration "Permanent link") No configuration required for this plugin. ## Usage[ΒΆ](#usage "Permanent link") The following examples show how to check whether the device can send SMS messages and open the native SMS composer. ### Check whether the device can send SMS messages[ΒΆ](#check-whether-the-device-can-send-sms-messages "Permanent link") Check whether the device is able to compose and send SMS messages, for example to hide SMS-related features on devices without SMS capability such as Wi-Fi-only tablets or iPads. Only available on Android and iOS: `[](#%5F%5Fcodelineno-3-1)import { SmsComposer } from '@capawesome/capacitor-sms-composer'; [](#%5F%5Fcodelineno-3-2) [](#%5F%5Fcodelineno-3-3)const canComposeSms = async () => { [](#%5F%5Fcodelineno-3-4) const { canCompose } = await SmsComposer.canComposeSms(); [](#%5F%5Fcodelineno-3-5) return canCompose; [](#%5F%5Fcodelineno-3-6)}; ` ### Open the SMS composer[ΒΆ](#open-the-sms-composer "Permanent link") Open the native SMS composer prefilled with recipients and a message body. The user reviews the message and decides whether to send it; the plugin never sends the message itself. The call resolves with a `status` once the composer is dismissed (see [Result Status](#result-status)). Only available on Android and iOS: `[](#%5F%5Fcodelineno-4-1)import { SmsComposer } from '@capawesome/capacitor-sms-composer'; [](#%5F%5Fcodelineno-4-2) [](#%5F%5Fcodelineno-4-3)const composeSms = async () => { [](#%5F%5Fcodelineno-4-4) const { status } = await SmsComposer.composeSms({ [](#%5F%5Fcodelineno-4-5) recipients: ['+41791234567'], [](#%5F%5Fcodelineno-4-6) body: 'Hello from Capacitor!', [](#%5F%5Fcodelineno-4-7) }); [](#%5F%5Fcodelineno-4-8) return status; [](#%5F%5Fcodelineno-4-9)}; ` ## API[ΒΆ](#api "Permanent link") * [canComposeSms()](#cancomposesms) * [composeSms(...)](#composesms) * [Interfaces](#interfaces) * [Type Aliases](#type-aliases) ### canComposeSms()[ΒΆ](#cancomposesms "Permanent link") `[](#%5F%5Fcodelineno-5-1)canComposeSms() => Promise ` Check whether the device is able to compose and send SMS messages. On devices without SMS capability (e.g. Wi-Fi-only tablets or iPads), this resolves with `canCompose` set to `false`. Only available on Android and iOS. **Returns:** `Promise<[CanComposeSmsResult](#cancomposesmsresult)>` **Since:** 0.1.0 --- ### composeSms(...)[ΒΆ](#composesms "Permanent link") `[](#%5F%5Fcodelineno-6-1)composeSms(options: ComposeSmsOptions) => Promise ` Open the native SMS composer prefilled with the given recipients and body. The user reviews the message and decides whether to send it. The plugin never sends the message itself. The call resolves once the composer is dismissed. If the device is not able to compose SMS messages, the call rejects as unavailable. Only available on Android and iOS. | Param | Type | | ----------- | --------------------------------------- | | **options** | [ComposeSmsOptions](#composesmsoptions) | **Returns:** `Promise<[ComposeSmsResult](#composesmsresult)>` **Since:** 0.1.0 --- ### Interfaces[ΒΆ](#interfaces "Permanent link") #### CanComposeSmsResult[ΒΆ](#cancomposesmsresult "Permanent link") | Prop | Type | Description | Since | | -------------- | ------- | ------------------------------------------------------------ | ----- | | **canCompose** | boolean | Whether the device is able to compose and send SMS messages. | 0.1.0 | #### ComposeSmsResult[ΒΆ](#composesmsresult "Permanent link") | Prop | Type | Description | Since | | ---------- | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- | | **status** | [SmsComposeStatus](#smscomposestatus) | The status of the SMS composer after it was dismissed. On Android, the status is always unknown because the system does not report whether the message was sent. | 0.1.0 | #### ComposeSmsOptions[ΒΆ](#composesmsoptions "Permanent link") | Prop | Type | Description | Since | | -------------- | ---------- | ---------------------------------------------------------- | ----- | | **body** | string | The message body to prefill in the composer. | 0.1.0 | | **recipients** | string\[\] | The recipients (phone numbers) to prefill in the composer. | 0.1.0 | ### Type Aliases[ΒΆ](#type-aliases "Permanent link") #### SmsComposeStatus[ΒΆ](#smscomposestatus "Permanent link") The status of the SMS composer after it was dismissed. * `sent`: The user sent the message. * `canceled`: The user canceled the composer without sending the message. * `unknown`: The result is unknown. This is always the case on Android. `'canceled' | 'sent' | 'unknown'` ## Result Status[ΒΆ](#result-status "Permanent link") The `composeSms(...)` method resolves with a `status` once the composer is dismissed: * On **iOS**, the status reflects the actual outcome (`sent`, `canceled`). * On **Android**, the status is always `unknown` because the system does not report whether the message was sent. ## Multiple Recipients[ΒΆ](#multiple-recipients "Permanent link") Multiple recipients are joined with a semicolon (`;`) in the underlying `smsto:` URI on Android. Some messaging apps expect a comma (`,`) instead, so multi-recipient prefilling may not work reliably across all Android messaging apps. ## 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 opens the native SMS composer prefilled with recipients and a message body through a fully typed API, with a `canComposeSms()` check so you can hide the feature on devices without SMS capability such as Wi-Fi-only tablets. The user always reviews and sends the message, so no SMS permissions are needed, and on iOS you get the real send status back. If you only need a basic `smsto:` link, that's simple enough; if you want capability detection and a consistent composer across Android and iOS, this plugin is designed for exactly that. ### Does the plugin send SMS messages automatically?[ΒΆ](#does-the-plugin-send-sms-messages-automatically "Permanent link") No, the plugin never sends SMS messages on its own. It opens the native SMS composer prefilled with the recipients and message body you provide, and the user always reviews the message and decides whether to send it. This makes the plugin privacy-friendly and avoids the need for any SMS permissions. ### Why is the status always `unknown` on Android?[ΒΆ](#why-is-the-status-always-unknown-on-android "Permanent link") On Android, the system does not report whether the message was sent after the composer is dismissed, so the `status` is always `unknown`. On iOS, the status reflects the actual outcome (`sent` or `canceled`). See [Result Status](#result-status) for details. ### How can I detect devices that cannot send SMS messages?[ΒΆ](#how-can-i-detect-devices-that-cannot-send-sms-messages "Permanent link") Call the `canComposeSms` method, which resolves with `canCompose` set to `false` on devices without SMS capability, such as Wi-Fi-only tablets or iPads. If you call `composeSms` on such a device anyway, the call rejects as unavailable. ### Why does prefilling multiple recipients not work in some Android messaging apps?[ΒΆ](#why-does-prefilling-multiple-recipients-not-work-in-some-android-messaging-apps "Permanent link") On Android, multiple recipients are joined with a semicolon (`;`) in the underlying `smsto:` URI, but some messaging apps expect a comma (`,`) instead. Multi-recipient prefilling may therefore not work reliably across all Android messaging apps. See [Multiple Recipients](#multiple-recipients) for details. ### Is any additional configuration required on Android?[ΒΆ](#is-any-additional-configuration-required-on-android "Permanent link") No, the plugin works out of the box. It declares the necessary `` element for the `smsto` scheme in its own `AndroidManifest.xml`, so the SMS capability can be detected on Android 11 (API level 30) and higher without manual manifest changes. ### 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") * [Android SMS Retriever](https://capawesome.io/docs/sdks/capacitor/android-sms-retriever/): OTP autofill on Android via the SMS User Consent and Phone Number Hint APIs. * [Contacts](https://capawesome.io/docs/sdks/capacitor/contacts/): Read, write, or select device contacts. * [Mail Composer](https://capawesome.io/docs/sdks/capacitor/mail-composer/): Open the native email composer. * [Phone Dialer](https://capawesome.io/docs/sdks/capacitor/phone-dialer/): Open the native phone dialer prefilled with a phone number. ## 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/sms-composer/CHANGELOG.md). ## License[ΒΆ](#license "Permanent link") See [LICENSE](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/sms-composer/LICENSE). July 8, 2026 Back to top ```json {"@context": "https://schema.org", "@graph": [{"@type": "TechArticle", "@id": "https://capawesome.io/docs/sdks/capacitor/sms-composer/#article", "headline": "Capacitor SMS Composer Plugin for Android & iOS", "name": "Capacitor SMS Composer Plugin for Android & iOS", "description": "Capacitor plugin to open the native SMS composer prefilled with recipients and a message body on Android and iOS.", "inLanguage": "en", "url": "https://capawesome.io/docs/sdks/capacitor/sms-composer/", "mainEntityOfPage": "https://capawesome.io/docs/sdks/capacitor/sms-composer/", "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/sms-composer/#software"}}, {"@type": "SoftwareSourceCode", "@id": "https://capawesome.io/docs/sdks/capacitor/sms-composer/#software", "name": "Capacitor SMS Composer Plugin for Android & iOS", "description": "Capacitor plugin to open the native SMS composer prefilled with recipients and a message body on Android and iOS.", "url": "https://capawesome.io/docs/sdks/capacitor/sms-composer/", "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 opens the native SMS composer prefilled with recipients and a message body through a fully typed API, with a canComposeSms() check so you can hide the feature on devices without SMS capability such as Wi-Fi-only tablets. The user always reviews and sends the message, so no SMS permissions are needed, and on iOS you get the real send status back. If you only need a basic smsto: link, that's simple enough; if you want capability detection and a consistent composer across Android and iOS, this plugin is designed for exactly that."}}, {"@type": "Question", "name": "Does the plugin send SMS messages automatically?", "acceptedAnswer": {"@type": "Answer", "text": "No, the plugin never sends SMS messages on its own. It opens the native SMS composer prefilled with the recipients and message body you provide, and the user always reviews the message and decides whether to send it. This makes the plugin privacy-friendly and avoids the need for any SMS permissions."}}, {"@type": "Question", "name": "Why is the status always unknown on Android?", "acceptedAnswer": {"@type": "Answer", "text": "On Android, the system does not report whether the message was sent after the composer is dismissed, so the status is always unknown. On iOS, the status reflects the actual outcome ( sent or canceled). See Result Status for details."}}, {"@type": "Question", "name": "How can I detect devices that cannot send SMS messages?", "acceptedAnswer": {"@type": "Answer", "text": "Call the canComposeSms method, which resolves with canCompose set to false on devices without SMS capability, such as Wi-Fi-only tablets or iPads. If you call composeSms on such a device anyway, the call rejects as unavailable."}}, {"@type": "Question", "name": "Why does prefilling multiple recipients not work in some Android messaging apps?", "acceptedAnswer": {"@type": "Answer", "text": "On Android, multiple recipients are joined with a semicolon (;) in the underlying smsto: URI, but some messaging apps expect a comma (,) instead. Multi-recipient prefilling may therefore not work reliably across all Android messaging apps. See Multiple Recipients for details."}}, {"@type": "Question", "name": "Is any additional configuration required on Android?", "acceptedAnswer": {"@type": "Answer", "text": "No, the plugin works out of the box. It declares the necessary element for the smsto scheme in its own AndroidManifest.xml, so the SMS capability can be detected on Android 11 (API level 30) and higher without manual manifest changes."}}, {"@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/sms-composer/"} ```