--- description: Apple now requires Capacitor apps to be built with Xcode 26 and the iOS 26 SDK. Here's what changed and how Capawesome Cloud handles it for you. title: Apple's New Xcode 26 Requirement for Capacitor Apps - Capawesome image: https://capawesome.io/docs/assets/images/social/blog/xcode-26-requirement-for-capacitor-apps.png --- [Skip to content ](#apples-new-xcode-26-requirement-for-capacitor-apps) [🖥️ 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/) * [ 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 * [ Try Capawesome Cloud ](#try-capawesome-cloud) * [ Final Thoughts ](#final-thoughts) # Apple's New Xcode 26 Requirement for Capacitor Apps[¶](#apples-new-xcode-26-requirement-for-capacitor-apps "Permanent link") Yesterday, April 28, 2026, Apple's new SDK requirement went into effect. Every app submitted to App Store Connect now has to be built with Xcode 26 and the iOS 26 SDK (or the matching SDKs for iPadOS, tvOS, visionOS, and watchOS). If you're shipping a Capacitor app, here's what changed — and why most Capawesome Cloud customers don't need to lift a finger. [ ![Build and deploy your Capacitor app with Capawesome Cloud](https://capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.png?t=1) ](/) ## What Apple Announced[¶](#what-apple-announced "Permanent link") Apple shared the change in a [developer notice in February 2026](https://developer.apple.com/news/upcoming-requirements/?id=02032026a). From April 28, 2026 onwards, any app or app update submitted to App Store Connect must be built with **Xcode 26 or later** using the SDKs for **iOS 26, iPadOS 26, tvOS 26, visionOS 26, or watchOS 26**. The previous baseline (Xcode 16 / iOS 18 SDK) is no longer accepted for new submissions. Apps already on the App Store keep working — but the next time you push an update, the build needs to be on the new toolchain. ## What This Means for Capacitor Developers[¶](#what-this-means-for-capacitor-developers "Permanent link") Capacitor itself is fully compatible with Xcode 26 and the iOS 26 SDK, so there's no Capacitor-side migration involved. The change is about the toolchain you build with, not your app code: * If you build locally on a Mac, you need Xcode 26 installed and selected via `xcode-select`. * If you build in CI, your runner needs to provide Xcode 26 — many older CI images still default to Xcode 16. * If you let a service like Capawesome Cloud build for you, the build stack you pick determines your Xcode version. That last point is where most teams will spend the least effort. ## Capawesome Cloud Has You Covered[¶](#capawesome-cloud-has-you-covered "Permanent link") Both [build stacks](/docs/cloud/native-builds/build-stacks/) on Capawesome Cloud already ship Xcode 26 as the default: | Build stack | Default Xcode | | ------------- | ------------- | | macos-sequoia | 26.0.1 | | macos-tahoe | 26.2 | If you've never explicitly overridden `XCODE_VERSION` in your build environment, you're already compliant. Your next build will produce a binary that App Store Connect accepts. ## When You Need to Act[¶](#when-you-need-to-act "Permanent link") There's exactly one case where action is required: you've pinned an older Xcode via the [XCODE\_VERSION reserved environment variable](/docs/cloud/native-builds/environment-variables/#reserved-variables). If your build environment still contains something like: `[](#%5F%5Fcodelineno-0-1)XCODE_VERSION=16.4 ` Either remove the variable to fall back to the default, or update it to a Xcode 26 release (`26.0.1` on `macos-sequoia`, `26.2` on `macos-tahoe`). Then trigger a fresh build — and you're done. ## FAQ[¶](#faq "Permanent link") ### Does an app already on the App Store stop working if it wasn't built with Xcode 26?[¶](#does-an-app-already-on-the-app-store-stop-working-if-it-wasnt-built-with-xcode-26 "Permanent link") No. Apps already live on the App Store keep working exactly as before — the requirement only applies the next time you submit a new build or update. There's no retroactive enforcement on binaries that already passed review. ### Do I need to change anything in my Capacitor app's code for this requirement?[¶](#do-i-need-to-change-anything-in-my-capacitor-apps-code-for-this-requirement "Permanent link") No. This is entirely a toolchain requirement, not a Capacitor compatibility issue — Capacitor itself is fully compatible with Xcode 26 and the iOS 26 SDK. The change is about which Xcode version compiles your app, not anything in your web or native project code. ### How do I know if my Capawesome Cloud builds are already compliant?[¶](#how-do-i-know-if-my-capawesome-cloud-builds-are-already-compliant "Permanent link") If you've never explicitly set the `XCODE_VERSION` reserved environment variable in your build environment, you're already compliant, since both build stacks (`macos-sequoia` and `macos-tahoe`) default to Xcode 26 releases. Compliance only becomes a concern if you previously pinned an older version like `XCODE_VERSION=16.4`. ### What happens if I submit a build made with an older Xcode version after the deadline?[¶](#what-happens-if-i-submit-a-build-made-with-an-older-xcode-version-after-the-deadline "Permanent link") Apple's stated policy is that submissions built with the older baseline (Xcode 16 / iOS 18 SDK) are no longer accepted from April 28, 2026 onwards — so a build made with an outdated toolchain would be rejected at submission rather than approved and flagged later. ### Is this a one-time requirement, or does Apple do this every year?[¶](#is-this-a-one-time-requirement-or-does-apple-do-this-every-year "Permanent link") Per this post, it's described as part of a routine annual cycle — Apple has a history of raising the minimum required Xcode/SDK version on a yearly cadence, tied to each year's new OS releases. That's also why keeping build stacks current is an ongoing effort rather than a single fix, as covered in [the new CLIs and Xcode 26 update](/blog/new-clis-and-xcode-26-in-capawesome-build-stacks/). ## Try Capawesome Cloud[¶](#try-capawesome-cloud "Permanent link") If you're still building Capacitor iOS apps on a local Mac and are tired of chasing Xcode upgrades every spring, Capawesome Cloud handles the toolchain for you — including future Apple deadlines like this one. [Try Capawesome Cloud Free](/) ## Final Thoughts[¶](#final-thoughts "Permanent link") Apple's Xcode 26 requirement is part of a routine annual cycle, but it's the kind of deadline that's easy to miss until your next App Store submission gets rejected. With Capawesome Cloud's default build stacks, the upgrade is automatic. The only thing to double-check is whether you've pinned an older Xcode version somewhere in your environment. If you'd like to go fully Mac-free for your iOS builds, our guide on [how to build and deploy iOS apps without owning a Mac](/blog/how-to-build-and-deploy-ios-apps-without-a-mac/) walks through the full setup. We also keep the build stacks current over time — see [the new CLIs and Xcode 26 in the Capawesome build stacks](/blog/new-clis-and-xcode-26-in-capawesome-build-stacks/) for the latest Xcode defaults and tooling. Questions? Join us on the [Capawesome Discord server](https://discord.gg/VCXxSVjefW) or subscribe to the [Capawesome newsletter](/newsletter/) to stay ahead of the next Apple deadline. July 17, 2026 Back to top ```json { "@context": "https://schema.org", "@type": "BlogPosting", "headline": "Apple\u0027s New Xcode 26 Requirement for Capacitor Apps", "description": "Apple now requires Capacitor apps to be built with Xcode 26 and the iOS 26 SDK. Here\u0027s what changed and how Capawesome Cloud handles it for you.", "image": "https://capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.png", "datePublished": "2026-04-29T00:00:00+00:00", "dateModified": "2026-07-17T00:00:00+00:00", "author": [ { "@type": "Person", "name": "Robin Genz", "url": "https://github.com/robingenz" } ], "publisher": { "@type": "Organization", "name": "Capawesome", "url": "https://capawesome.io", "logo": { "@type": "ImageObject", "url": "https://capawesome.io/assets/images/logo.svg" } }, "articleSection": "Capacitor", "keywords": ["Capacitor", "Cloud"], "isPartOf": { "@type": "Blog", "@id": "https://capawesome.io/blog/#blog" }, "mainEntityOfPage": "https://capawesome.io/blog/xcode-26-requirement-for-capacitor-apps/", "url": "https://capawesome.io/blog/xcode-26-requirement-for-capacitor-apps/" } { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://capawesome.io/" }, { "@type": "ListItem", "position": 2, "name": "Blog", "item": "https://capawesome.io/blog/" }, { "@type": "ListItem", "position": 3, "name": "Apple\u0027s New Xcode 26 Requirement for Capacitor Apps", "item": "https://capawesome.io/blog/xcode-26-requirement-for-capacitor-apps/" } ] } {"@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [{"@type": "Question", "name": "Does an app already on the App Store stop working if it wasn't built with Xcode 26?", "acceptedAnswer": {"@type": "Answer", "text": "No. Apps already live on the App Store keep working exactly as before — the requirement only applies the next time you submit a new build or update. There's no retroactive enforcement on binaries that already passed review."}}, {"@type": "Question", "name": "Do I need to change anything in my Capacitor app's code for this requirement?", "acceptedAnswer": {"@type": "Answer", "text": "No. This is entirely a toolchain requirement, not a Capacitor compatibility issue — Capacitor itself is fully compatible with Xcode 26 and the iOS 26 SDK. The change is about which Xcode version compiles your app, not anything in your web or native project code."}}, {"@type": "Question", "name": "How do I know if my Capawesome Cloud builds are already compliant?", "acceptedAnswer": {"@type": "Answer", "text": "If you've never explicitly set the XCODE_VERSION reserved environment variable in your build environment, you're already compliant, since both build stacks ( macos-sequoia and macos-tahoe) default to Xcode 26 releases. Compliance only becomes a concern if you previously pinned an older version like XCODE_VERSION=16.4."}}, {"@type": "Question", "name": "What happens if I submit a build made with an older Xcode version after the deadline?", "acceptedAnswer": {"@type": "Answer", "text": "Apple's stated policy is that submissions built with the older baseline (Xcode 16 / iOS 18 SDK) are no longer accepted from April 28, 2026 onwards — so a build made with an outdated toolchain would be rejected at submission rather than approved and flagged later."}}, {"@type": "Question", "name": "Is this a one-time requirement, or does Apple do this every year?", "acceptedAnswer": {"@type": "Answer", "text": "Per this post, it's described as part of a routine annual cycle — Apple has a history of raising the minimum required Xcode/SDK version on a yearly cadence, tied to each year's new OS releases. That's also why keeping build stacks current is an ongoing effort rather than a single fix, as covered in the new CLIs and Xcode 26 update."}}], "url": "https://capawesome.io/blog/xcode-26-requirement-for-capacitor-apps/"} ```