--- description: Capacitor plugin to sign in with Apple on Android, iOS, and Web. Supports authentication with identity tokens, authorization codes, and user profile retrieval. title: Capacitor Apple Sign-In Plugin for Android, iOS & Web - Capawesome image: https://capawesome.io/docs/assets/images/social/sdks/capacitor/apple-sign-in.png --- [Skip to content ](#capacitor-apple-sign-in-plugin) [πŸ” Introducing the **Capacitor Vault** plugin β€” store secrets behind biometrics or a device passcode. ](/blog/announcing-the-capacitor-vault-plugin/) * [ SDKs ](/docs/sdks/) * [ Configuration ](#configuration) * [ Usage ](#usage) * [ API ](#api) * [ Enums ](#enums) * [ Security ](#security) * [ FAQ ](#faq) * [ Related Plugins ](#related-plugins) * [ Newsletter ](#newsletter) * [ Changelog ](#changelog) * [ License ](#license) * [ 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/) * [ Datetime Picker ](/docs/sdks/capacitor/datetime-picker/) * [ Device Info ](/docs/sdks/capacitor/device-info/) * [ Dialog ](/docs/sdks/capacitor/dialog/) * [ 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/) * [ 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/) * [ 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/) * [ 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) * [ Enums ](#enums) * [ Security ](#security) * [ FAQ ](#faq) * [ Related Plugins ](#related-plugins) * [ Newsletter ](#newsletter) * [ Changelog ](#changelog) * [ License ](#license) # Capacitor Apple Sign-In Plugin[ΒΆ](#capacitor-apple-sign-in-plugin "Permanent link") Unofficial Capacitor plugin to sign-in with Apple.[1](#fn:1) [ ![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") The Capacitor Apple Sign-In plugin is one of the most complete Apple authentication solutions for Capacitor apps. Here are some of the key features: * πŸ–₯️ **Cross-platform**: Supports Android, iOS, and Web. * 🍎 **Native Sign-In**: Uses native AuthenticationServices on iOS. * 🌐 **WebView OAuth**: Implements Apple OAuth flow on Android without external dependencies. * πŸ“§ **Scope support**: Request email and full name on all platforms. * πŸ” **Nonce & state**: Supports nonce for replay protection and state for CSRF protection. * πŸͺΆ **Lightweight**: Just a single dependency and zero unnecessary bloat. * 🀝 **Compatibility**: Compatible with the [Google Sign-In](https://capawesome.io/docs/sdks/capacitor/google-sign-in/) and [OAuth](https://capawesome.io/docs/sdks/capacitor/oauth/) 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 Apple Sign-In plugin is typically used to let users authenticate with their Apple ID, for example: * **User authentication**: Offer Sign in with Apple as a login option in your app on Android, iOS, and Web. * **Account creation**: Request the user's email address and full name during sign-up using the email and full name scopes. * **Backend integration**: Send the authorization code and ID token to your backend to verify the sign-in and create a user session. * **Secure sign-in flows**: Pass a nonce for replay protection and a state value for CSRF protection. ## Compatibility[ΒΆ](#compatibility "Permanent link") | Plugin Version | Capacitor Version | Status | | -------------- | ----------------- | -------------- | | 0.1.x | \>=8.x.x | Active support | ## Guides[ΒΆ](#guides "Permanent link") * [How to Sign In with Apple using Capacitor](https://capawesome.io/blog/how-to-sign-in-with-apple-using-capacitor/) ## 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-apple-sign-in` 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-apple-sign-in [](#%5F%5Fcodelineno-2-2)npx cap sync ` ### iOS[ΒΆ](#ios "Permanent link") Add the **Sign in with Apple** capability to your app in Xcode: 1. Open your app target in Xcode. 2. Go to the **Signing & Capabilities** tab. 3. Click **\+ Capability** and add **Sign in with Apple**. ### Web[ΒΆ](#web "Permanent link") The plugin loads the [Apple JS SDK](https://developer.apple.com/documentation/sign%5Fin%5Fwith%5Fapple/sign%5Fin%5Fwith%5Fapple%5Fjs) automatically. Make sure you have configured your Apple Service ID with the correct redirect URL and web domain in the [Apple Developer Portal](https://developer.apple.com/account/resources/identifiers/list/serviceId). ## Configuration[ΒΆ](#configuration "Permanent link") No configuration required for this plugin. ## Usage[ΒΆ](#usage "Permanent link") The following examples show how to initialize the plugin and sign in with Apple. ### Initialize the plugin[ΒΆ](#initialize-the-plugin "Permanent link") On Android and Web, you must initialize the plugin with your Apple Service ID before calling `signIn(...)`. This method is only available on Android and Web: `[](#%5F%5Fcodelineno-3-1)import { AppleSignIn } from '@capawesome/capacitor-apple-sign-in'; [](#%5F%5Fcodelineno-3-2) [](#%5F%5Fcodelineno-3-3)const initialize = async () => { [](#%5F%5Fcodelineno-3-4) await AppleSignIn.initialize({ [](#%5F%5Fcodelineno-3-5) clientId: 'com.example.app.signin', [](#%5F%5Fcodelineno-3-6) }); [](#%5F%5Fcodelineno-3-7)}; ` ### Sign in with Apple[ΒΆ](#sign-in-with-apple "Permanent link") Start the sign-in flow and receive the authorization code and ID token. Use the `scopes` option to request the user's email address and full name, and pass a `nonce` for replay protection. The `redirectUrl` and `state` options are only available on Android and Web: `[](#%5F%5Fcodelineno-4-1)import { AppleSignIn, SignInScope } from '@capawesome/capacitor-apple-sign-in'; [](#%5F%5Fcodelineno-4-2) [](#%5F%5Fcodelineno-4-3)const signIn = async () => { [](#%5F%5Fcodelineno-4-4) const result = await AppleSignIn.signIn({ [](#%5F%5Fcodelineno-4-5) scopes: [SignInScope.Email, SignInScope.FullName], [](#%5F%5Fcodelineno-4-6) redirectUrl: 'https://example.com/callback', [](#%5F%5Fcodelineno-4-7) nonce: 'random-nonce', [](#%5F%5Fcodelineno-4-8) state: 'random-state', [](#%5F%5Fcodelineno-4-9) }); [](#%5F%5Fcodelineno-4-10) return result; [](#%5F%5Fcodelineno-4-11)}; ` ## API[ΒΆ](#api "Permanent link") * [initialize(...)](#initialize) * [signIn(...)](#signin) * [Interfaces](#interfaces) * [Enums](#enums) ### initialize(...)[ΒΆ](#initialize "Permanent link") `[](#%5F%5Fcodelineno-5-1)initialize(options: InitializeOptions) => Promise ` Initialize the plugin. This method must be called before `signIn()` on **Android** and **Web**. Only available on Android and Web. | Param | Type | | ----------- | --------------------------------------- | | **options** | [InitializeOptions](#initializeoptions) | **Since:** 0.1.0 --- ### signIn(...)[ΒΆ](#signin "Permanent link") `[](#%5F%5Fcodelineno-6-1)signIn(options?: SignInOptions | undefined) => Promise ` Sign in with Apple. | Param | Type | | ----------- | ------------------------------- | | **options** | [SignInOptions](#signinoptions) | **Returns:** `Promise<[SignInResult](#signinresult)>` **Since:** 0.1.0 --- ### Interfaces[ΒΆ](#interfaces "Permanent link") #### InitializeOptions[ΒΆ](#initializeoptions "Permanent link") | Prop | Type | Description | Since | | ------------ | ------ | ---------------------------------------- | ----- | | **clientId** | string | The Apple Service ID to use for sign-in. | 0.1.0 | #### SignInResult[ΒΆ](#signinresult "Permanent link") | Prop | Type | Description | Since | | --------------------- | --------------------------------- | ----------------------------------------------------------------------------------------------------- | ----- | | **authorizationCode** | string | The authorization code. | 0.1.0 | | **idToken** | string | The ID token (JWT). | 0.1.0 | | **user** | string | The stable Apple user identifier. On **Android** and **Web**, this is decoded from the JWT sub claim. | 0.1.0 | | **email** | string \| null | The user's email address. On **iOS**, this is only provided on the first sign-in. | 0.1.0 | | **givenName** | string \| null | The user's given name. On **iOS**, this is only provided on the first sign-in. | 0.1.0 | | **familyName** | string \| null | The user's family name. On **iOS**, this is only provided on the first sign-in. | 0.1.0 | | **state** | string | The state value from the sign-in request. Only available on Android and Web. | 0.1.0 | | **realUserStatus** | [RealUserStatus](#realuserstatus) | The real user status. Only available on iOS. | 0.1.0 | #### SignInOptions[ΒΆ](#signinoptions "Permanent link") | Prop | Type | Description | Since | | --------------- | --------------- | ----------------------------------------------------------------------------- | ----- | | **redirectUrl** | string | The OAuth redirect URL to use for sign-in. Only available on Android and Web. | 0.1.0 | | **scopes** | SignInScope\[\] | The scopes to request during sign-in. | 0.1.0 | | **nonce** | string | A nonce for replay protection. | 0.1.0 | | **state** | string | A state value for CSRF protection. Only available on Android and Web. | 0.1.0 | ### Enums[ΒΆ](#enums "Permanent link") #### RealUserStatus[ΒΆ](#realuserstatus "Permanent link") | Members | Value | Description | Since | | --------------- | -------------- | ------------------------------------------------------------- | ----- | | **LikelyReal** | 'LIKELY\_REAL' | The user appears to be a real person. | 0.1.0 | | **Unknown** | 'UNKNOWN' | The system can't determine whether the user is a real person. | 0.1.0 | | **Unsupported** | 'UNSUPPORTED' | The real user status is not supported on this platform. | 0.1.0 | #### SignInScope[ΒΆ](#signinscope "Permanent link") | Members | Value | Description | Since | | ------------ | ------------ | --------------------------------- | ----- | | **Email** | 'EMAIL' | Request the user's email address. | 0.1.0 | | **FullName** | 'FULL\_NAME' | Request the user's full name. | 0.1.0 | ## Security[ΒΆ](#security "Permanent link") This plugin handles the OAuth flow and returns tokens to your app. To keep your integration secure, be aware of the following: * **Server-side token verification is required.** The `idToken` (JWT) is **not** verified client-side. Your backend **must** verify the JWT signature using [Apple's public keys](https://appleid.apple.com/auth/keys) before trusting any claims (e.g. `user`, `email`). Never use client-side token data for authorization decisions without server-side verification. * **Validate the `state` parameter.** The plugin passes the `state` value through to the result but does **not** validate it. Your app must compare the returned `state` against the value it originally sent to protect against CSRF attacks. * **Android uses a WebView-based OAuth flow.** Unlike iOS (which uses native `AuthenticationServices`), the Android implementation renders Apple's sign-in page in a WebView. Unlike a system browser flow, the WebView is controlled by the app and has access to page content. Ensure your `redirectUrl` uses HTTPS and points to a domain you control. ## FAQ[ΒΆ](#faq "Permanent link") ### What's the difference between this plugin and other Apple Sign-In plugins?[ΒΆ](#whats-the-difference-between-this-plugin-and-other-apple-sign-in-plugins "Permanent link") This plugin is purpose-built for Apple Sign-In and focuses on providing a clean and modern API with the latest platform features. Here are some of the key differences: * **Cross-platform**: Supports Android, iOS, and Web. * **Lightweight**: No unnecessary dependencies. Just Apple Sign-In, nothing else. * **No deprecated APIs**: Uses the latest platform APIs (AuthenticationServices on iOS). * **Scope support**: Request email and full name on all platforms. * **Error codes**: Provides typed error codes for proper error handling. ### Do I need to call initialize on iOS?[ΒΆ](#do-i-need-to-call-initialize-on-ios "Permanent link") No, the `initialize(...)` method is only available on Android and Web, where it must be called before `signIn(...)` to set the Apple Service ID. On iOS, the plugin uses the native AuthenticationServices framework and no initialization is required. ### Why are the email and name only returned on the first sign-in on iOS?[ΒΆ](#why-are-the-email-and-name-only-returned-on-the-first-sign-in-on-ios "Permanent link") On iOS, Apple only provides the user's email address, given name, and family name on the first sign-in; on subsequent sign-ins, these values are `null`. Make sure to persist this information, for example on your backend, when you receive it for the first time. ### 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") * [Google Sign-In](https://capawesome.io/docs/sdks/capacitor/google-sign-in/): Sign in with Google. * [Facebook Sign-In](https://capawesome.io/docs/sdks/capacitor/facebook-sign-in/): Sign in with Facebook. * [OAuth](https://capawesome.io/docs/sdks/capacitor/oauth/): Communicate with OAuth 2.0 and OpenID Connect providers. * [Passkeys](https://capawesome.io/docs/sdks/capacitor/passkeys/): Create and authenticate with passkeys based on the WebAuthn standard. ## 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/apple-sign-in/CHANGELOG.md). ## License[ΒΆ](#license "Permanent link") See [LICENSE](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/apple-sign-in/LICENSE). --- 1. This project is not affiliated with, endorsed by, sponsored by, or approved by Apple Inc. or any of their affiliates or subsidiaries. [↩](#fnref:1 "Jump back to footnote 1 in the text") July 8, 2026 Back to top ```json {"@context": "https://schema.org", "@graph": [{"@type": "TechArticle", "@id": "https://capawesome.io/docs/sdks/capacitor/apple-sign-in/#article", "headline": "Capacitor Apple Sign-In Plugin for Android, iOS & Web", "name": "Capacitor Apple Sign-In Plugin for Android, iOS & Web", "description": "Capacitor plugin to sign in with Apple on Android, iOS, and Web. Supports authentication with identity tokens, authorization codes, and user profile retrieval.", "inLanguage": "en", "url": "https://capawesome.io/docs/sdks/capacitor/apple-sign-in/", "mainEntityOfPage": "https://capawesome.io/docs/sdks/capacitor/apple-sign-in/", "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/apple-sign-in/#software"}}, {"@type": "SoftwareSourceCode", "@id": "https://capawesome.io/docs/sdks/capacitor/apple-sign-in/#software", "name": "Capacitor Apple Sign-In Plugin for Android, iOS & Web", "description": "Capacitor plugin to sign in with Apple on Android, iOS, and Web. Supports authentication with identity tokens, authorization codes, and user profile retrieval.", "url": "https://capawesome.io/docs/sdks/capacitor/apple-sign-in/", "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": "What's the difference between this plugin and other Apple Sign-In plugins?", "acceptedAnswer": {"@type": "Answer", "text": "This plugin is purpose-built for Apple Sign-In and focuses on providing a clean and modern API with the latest platform features. Here are some of the key differences: Cross-platform: Supports Android, iOS, and Web. Lightweight: No unnecessary dependencies. Just Apple Sign-In, nothing else. No deprecated APIs: Uses the latest platform APIs (AuthenticationServices on iOS). Scope support: Request email and full name on all platforms. Error codes: Provides typed error codes for proper error handling."}}, {"@type": "Question", "name": "Do I need to call initialize on iOS?", "acceptedAnswer": {"@type": "Answer", "text": "No, the initialize(...) method is only available on Android and Web, where it must be called before signIn(...) to set the Apple Service ID. On iOS, the plugin uses the native AuthenticationServices framework and no initialization is required."}}, {"@type": "Question", "name": "Why are the email and name only returned on the first sign-in on iOS?", "acceptedAnswer": {"@type": "Answer", "text": "On iOS, Apple only provides the user's email address, given name, and family name on the first sign-in; on subsequent sign-ins, these values are null. Make sure to persist this information, for example on your backend, when you receive it for the first time."}}, {"@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/apple-sign-in/"} ```