iOS & iPadOS 27 Beta 4 Release Notes
Update your apps to use new features, and test your apps against API changes.
Overview
The iOS & iPadOS 27 SDK provides support to develop apps for iPhone and iPad running iOS & iPadOS 27 beta 4. The SDK comes bundled with Xcode 27, available from the Mac App Store. For information on the compatibility requirements for Xcode 27, see Xcode 27 Release Notes.
AirPlay
Resolved Issues
Fixed: AirPlay to Home Theaters fails when a PIN or password is required. (176462871)
AirPods Max 2
Resolved Issues
Fixed: You cannot update AirPods Max 2 firmware beta in iOS 27 Beta 1 and macOS 27 Beta 1. AirPods Max 2 firmware beta updates are supported in iOS 27 Beta 2 and macOS 27 Beta 2. (178280323)
AirPort Utility
Deprecations
AirPort Utility will no longer be available for new downloads from the App Store. If you previously downloaded the app, you can still re-download it. When using AirPort Utility on iOS 27 and later, functionality is not guaranteed. (158364073)
App Intents
New Features
You can now pass a name parameter of type
AttributedStringto thenotes.createNoteandnotes.updateNoteschemas. (173431080)
Resolved Issues
Fixed: Non-SF Symbol custom images for app entities might not always appear in Siri. (175031314)
Fixed: Default values from schemas might not be applied for parameters that are of “Set” type. (175534195)
Fixed: Entities you register using
RelevantEntitiesfor the workout audio context might not appear as suggestions in Fitness media picker. (177996973)
Known Issues
AppEntity instances have a cumulative size limit of 10MB, including all child properties and their values. Your app might crash if an entity exceeds this limit, and the exception is logged. (181763422)
Deprecations
The
calendar.deleteEventsschema has been renamed tocalendar.deleteEvent. (176751155)
Apple Intelligence Report
Resolved Issues
Fixed: When you view Apple Intelligence Report entries for Home Intelligence, some data that was sent to Private Cloud Compute won’t appear in the report. (176056930)
AudioAccessoryKit
New Features
AudioAccessoryKit now allows third-party audio accessory manufacturers to provide headphone information to the system to support fixed spatial audio. It is only available for developer testing on iPhone and iPad in this release, and will be available to customers in the EU in a future iOS 27 and iPadOS 27 release. (178275661)
Background Assets
New Features
You can reduce your app’s storage usage with localized asset packs. The system delivers the appropriately localized asset packs based on the user’s preferred languages. (163944365)
Battery / Power Management
Resolved Issues
Fixed: Devices with a deeply discharged battery might fail to boot into the OS and remain stuck on the red dead battery icon screen indefinitely until the device is rebooted or the power adapter is unplugged and reconnected. (177346712)
Camera
Resolved Issues
Fixed: In the Camera app, Portrait mode blur effect might render incorrectly for photos. (177335723)
CarPlay
Resolved Issues
Fixed:
CPNavigationSessionETA Tray panel items might not receive focus. (177508893)Fixed: The panel delegate method
panelDidHide(_ panel: CPMapPanel)might not be called. (177590525)Fixed: The symbol button handler of
CPMapPanelButtonConfigurationmight not be called. (177595560)Fixed: Your vehicle’s next and previous track steering wheel buttons might not function correctly in CarPlay. (177832695)
Fixed: In CarPlay, playback of stereo music content might be silent after playback of Spatial Audio content. (178189709)
Known Issues
Under certain configurations,
CPMapPanelmight not dismiss when you tap the close button. (177592347)Siri might respond more slowly than expected in CarPlay, particularly under higher device temperatures or poor network conditions. (178952858)
Workaround: Try the request again after the device has cooled down or once you are in an area with better cellular reception.
Clock
Resolved Issues
Fixed: You might be unable to stop a ringing alarm from the lock screen without unlocking your device. (177728602)
CloudKit
Resolved Issues
Fixed: Saving a
CKSharein which an administrator participant has changed their own role toCKShareParticipantRole.privateUser(self-demotion) has no effect. (177621316)
Control Center
Resolved Issues
Fixed: The “Add a Control” button in edit mode might appear small and clipped. (170774279)
Core AI
New Features
iOS 27 includes Neural Engine improvements for Apple Intelligence capable devices. The system now restricts background access to the Neural Engine, similar to GPU usage restrictions. Large model loading (over 1 GB) performance is improved on the Neural Engine. Neural Engine memory usage is now attributed to your app process instead of the system, and appears in the Allocations instrument. (174796039)
Access to the Neural engine when your app is in the background requires the new entitlement: “com.apple.developer.background-tasks.continued-processing.inference”. (179282606)
Resolved Issues
Fixed:
AIModelCacheentries might not honor the cache policy you provide, causing re-specialization to occur more often than expected. (169746264)Fixed: When inference runs on the GPU,
InferenceFunction.encodeblocks until all compute is complete instead of returning as soon as encoding is done, unless the model is specialized with a preferred compute device of GPU. (175789258)Fixed: Certain weight and activation configurations may not run on the Neural Engine, such as FP8-quantized weights and activations, palettized weights with quantized (non-Float16) values, and sparse weights. Affected models may run on the CPU or GPU instead. (176210080)
Fixed: When you run
InferenceFunction.runon functions with both state arguments and outputs with dynamic shapes, the framework might be unable to infer the shape of the outputs and throw an error. (176807213)Fixed: On-device specialization fails when loading an
.aimodelconverted withcoreai-torchv0.4.0. (177008303)Fixed: Inference might fail or crash for models with control flow over dynamic-shape tensors (for example, linear-attention LLMs such as Qwen3.5/3.6). (177354777)
Fixed: When Metal API Validation is enabled, CoreAI models might fail to execute. (177991751)
Fixed: Models with custom Metal kernels will fail to load. (178056451)
Fixed: App-group support might not work as expected on certain model types. (179732320)
Fixed: On-device specialization might fail when loading an
.aimodelccompiled ahead of time using Xcode 27 Beta 2 or earlier. (181264112)
Known Issues
Ahead-of-time (AOT) compilation might fail unexpectedly for certain models. (177729331)
Core Bluetooth
Resolved Issues
Fixed: The Channel Sounding API in Core Bluetooth is not returning ranging results. (178333845)
Developer Settings
Resolved Issues
Fixed: Deep links into Settings > Developer > Paired Macs might silently fail to navigate to the target Mac computer. The Paired Macs pane loads correctly when entered manually. (178063365)
Dictation
New Features
Dictation can now be powered by a new on-device model that boosts accuracy. To enable this, go to Keyboard settings > Dictation and Toggle on “Advanced Dictation Preview”. (178444388)
Resolved Issues
Fixed: The “New Line” and “All Caps” formatting commands might not work reliably in the dictation UI. (177959708)
Fixed: Dictation might insert extra words at the end of a dictated passage that you did not speak. (178269104)
Known Issues
Voice Editing commands such as “Change X to Y”, “Delete X”, and “Undo/Redo” might not work reliably. (173448573)
When you explicitly dictate punctuation— such as “Period” or “Colon” — both the spoken command word and the punctuation character might be inserted instead of the punctuation character alone. (178078177)
Dictation might not recognize names from your contacts. (178079519)
Family Settings
Resolved Issues
Fixed: Family member’s Ask To Buy, Apple Cash, Purchases, Subscription rows cannot be accessed. (178546389)
Files
Resolved Issues
Fixed: Deleting files from Recently Deleted might fail with an error or experience significant delays. (179787658)
Fixed: Users might be unable to delete or open a file whose name contains certain Unicode characters if the name was created before this issue was addressed. (181179631)
Finder
Resolved Issues
Fixed: Suggested names for a file or folder might be more generic than its contents. For example, a folder containing only bird photos might receive suggestions like “Wildlife” or “Animal Photos” rather than bird-specific names. (178093786)
FindMy
Known Issues
Siri might not be able to find some of the people sharing location with you in FindMy. (178384345)
First-Party App Search
Resolved Issues
Fixed: Search assets might download slowly for languages and regions other than English and the United States, causing degraded search experiences for first-party apps up to a few hours after you install or upgrade to the latest OS, change your device language, or region. (178186226)
Fitness+
Resolved Issues
Fixed: On larger iPhones in landscape orientation, the Workout Detail view may display duplicate title text and action buttons when browsing workouts or meditations. (177964121)
Foundation
Resolved Issues
Fixed:
+[NSURL URLWithString:]no longer double-encodes the%of valid percent-escape sequences when encoding other invalid characters. (161588649) (FB20439045)
Foundation Models
Resolved Issues
Fixed: Private Cloud Compute might not work when you use simulators. (177684296)
Fixed:
@Generableon anenumproduces a deprecation warning aboutGenerationErrorthat cannot be silenced. (177899620)Fixed: Truncating transcript history in the
onPromptmodifier might cause an unexpected runtime error. (177901494)Fixed:
onPromptmight not be called when applied to aProfilewithout instructions. (177902488)Fixed:
PrivateCloudComputeLanguageModelalways uses greedy decoding. (178181782)
Known Issues
When using the on-device Apple Foundation Model for both tool calling and guided generation, some prompts might cause the model to call tools excessively. (177748926)
Workaround: Adjust your instructions, prompts, and attachment labels.
Game Center
Resolved Issues
Fixed: When you trigger the Access Point, its completion handler is never invoked. (172683368)
Game Controller
New Features
The PlayStation® Access™ controller is now supported on macOS, iPadOS, and iOS. You can create custom input profiles in game controller settings and save them to your Apple device. (168071382)
HealthKit
New Features
HealthKit now supports heart rate and cycling power zones. (135746152)
Updated HealthKit permissions flow now lets users grant apps access to limited history or full history. (172310874)
HealthKit adds support for tracking menopausal state and bleeding after menopause; two new sample types are available. HKCategoryTypeIdentifierMenopausalState records a person’s current menopausal state. Values defined by HKCategoryValueMenopausalState are menopause, perimenopause, and none. HKCategoryTypeIdentifierBleedingAfterMenopause records bleeding episodes occurring after menopause. Values use the existing vaginal bleeding flow levels: unspecified, light, medium, and heavy. Both types are read/write, classified under Reproductive Health, and require the standard HealthKit category type authorization. (178532053)
Hearing Test
Resolved Issues
Fixed: During a Hearing Test, visual feedback might not appear when you tap the screen to indicate a tone was heard. (176360906)
Home Screen
Resolved Issues
Fixed: Switching between many different posters with different icon tints may cause system sluggishness. (178435221)
Fixed: The Home Screen Customization on a newly setup device might not save. (178576719)
HomeKit
New Features
When Apple Intelligence in the Home app is enabled, your HomeKit Secure Video recordings are processed on-device and through Private Cloud Compute for video descriptions and search. (178858470)
Apple Intelligence for Home requires an iCloud+ subscription starting at 2TB. (181282161)
Image Playground
Resolved Issues
Fixed: When VoiceOver is enabled and the gallery contains only one image, the prompt input UI might not appear. (175357842)
Fixed: When Image Wand encounters an error — such as an unsupported flow or unsafe output — you might see the misleading message “Connect to Wi-Fi to create images” even when your device is already connected to Wi-Fi. (177710762)
Fixed: In the Image Playground photo picker, the All and Suggested tabs are missing, which might limit the number of photos available for you to choose from. (178256174)
Known Issues
If required models are downloading, you might see an error message instead of download progress information. (177833994)
Workaround: This issue occurs only on first install. Wait for the models to finish downloading, then try again.
iPhone Mirroring
Resolved Issues
Fixed: In rare cases, iPhone Mirroring may not resize correctly even after pressing the home button in the mirroring app. (180961142)
Fixed: Restarting an app while iPhone Mirroring is active can result in the screen appearing to freeze and resizing being disabled. (181023494)
Fixed: iPhone Mini does not resize properly during iPhone Mirroring. (181057810)
Keyboard
Resolved Issues
Fixed: Unlocalized text can appear for paste candidates. (180881635)
LDCM
Resolved Issues
Fixed: When your device’s charging port is wet but empty, you might see a dialog instructing you to unplug a charger or accessory even though nothing is connected. (175484509)
Lock Screen
Resolved Issues
Fixed: After dismissing Lock Screen, the Lock Screen grabber might appear in the incorrect location or orientation. (178174745)
Fixed: Siri and Search may still be available when locked even if they are disabled under “Allow Access When Locked” in Settings. (178283603)
Fixed: Portions of Depth Effect–enabled wallpapers might appear earlier than expected while pulling down Notification Center. (181621150)
Known Issues
Starting a Vision Pro Guest Mode session might result in two Live Activities on screen at the same time. (178200601)
Workaround: Dismiss the Lock Screen and re-lock the device.
Resolved Issues
Fixed: Emails might display content that doesn’t match their subject line. (169101671)
Mail Banners
Resolved Issues
Fixed: Mail banners for early flights will show the flight status as delayed. (173869986)
Media Sharing Extensions
New Features
New frameworks allow you to add media sharing protocols through extension at the system level and enable media apps to use these extensions through a common API framework. (168722808)
Resolved Issues
Fixed: Due to a mismatch in runtime checks with the mandatory entitlement for
MediaSharingExtensions, extensions using the newMediaDeviceExtensionframework can build but don’t run on target devices. (178179521)
Messages
Resolved Issues
Fixed: Stickers attached to a message from an unknown sender do not appear. (177453147)
Fixed: GIFs and pasted images might render as the incorrect size. (177657977)
Fixed: HDR screenshots might appear garbled when sent in Messages. (180859837)
Metal
Resolved Issues
Fixed: When you use a sampler to read from a texture with clamp-to-edge addressing mode, the result might be clamped to zero. (172520325)
Fixed: On devices in the Apple 10 GPU family, using a sampler to read from a texture with clamp-to-edge addressing mode might produce results that are clamped to zero. (177318505)
MetricKit
New Features
CrashDiagnosticnow includes aterminationCategorythat maps to the corresponding case inForegroundTerminationMetricandBackgroundTerminationMetric. (96078210) (FB10494149)Apps that emit developer-defined states through the
StateReportingframework now receive metrics and diagnostics in the context of those states. (159889985)MemoryExceptionDiagnosticare available when your app or app extension is terminated for exceeding its memory limit. (159890067)A new application-level
MetalFrameRateMetricis available for Metal frame pacing rendering insights perCAMetalLayer. (159890165)A new Swift-first
MetricManagerAPI enables your app to receiveMetricReportandDiagnosticReportobjects throughAsyncStream.MetricReportcontains a daily aggregated entry along with interval-based breakdowns that are typically a few hours each. (164439529)
Deprecations
The original MetricKit APIs — including
MXMetricManager,MXMetricManagerSubscriber,MXMetricPayload, andMXDiagnosticPayload— are no longer recommended for new adoption. UseMetricManagerinstead. (174892111)
Nearby Interaction
Resolved Issues
Fixed: The Channel Sounding API in Nearby Interaction does not return ranging results. (178073051)
Network Security
New Features
Starting in 27.0 operating systems, select system processes now enforce stricter network security (TLS) requirements. These new requirements might cause connections to fail if the server does not meet them. The affected processes are those involved in MDM, DDM, Automated Device Enrollment, configuration profile installation, app installation, and software updates. Servers must support TLS 1.2 at minimum, using cipher suites and certificates that meet App Transport Security (ATS) requirements.
For additional details on affected processes, requirements, and how to audit and diagnose failures in managed environments, please reference Prepare your network environment for stricter security requirements. For additional details on ATS and the new requirements, please reference Preventing Insecure Network Connections and NSRequiresNIAPTLSPackageVersion. (176055825)
NetworkExtension
Resolved Issues
Fixed: When an active VPN configuration sets
includeAllNetworksto true,excludeLocalNetworksfails to exclude wired connections to CarPlay. (176839377)
Notifications
Resolved Issues
Fixed: Critical alerts will be automatically turned on for any apps that request your permission to enable notifications. (179179362)
On Demand Resources
Deprecations
On Demand Resources and the
NSBundleResourceRequestAPI are deprecated. Use Background Assets instead. (170066290)
PencilKit
Deprecations
__PKStrokeRenderStatehas been renamed toPKStrokeRenderStateReference, withPKStrokeRenderStateReference.init(…)replacingPKStrokeRenderState.asObjCRenderState(). (176410709)
Photos
Resolved Issues
Fixed: When opened from a grid of Photos search results in Siri on iPadOS, the single-photo viewer might appear blank. (169236746)
Fixed: You might see a slight shift in color hues after applying Spatial Reframing to photos. (176384327)
Fixed: When sharing a Live Photo from the Photos app, you might not be able to disable the Live Photo effect prior to sending. (178093956)
Fixed: Photos app might quit unexpectedly when you re-enter the Extend tool on a photo that has already been extended. (178164434)
Photos Edit
Known Issues
A thin white line might be visible in photos that have had Spatial Reframing applied. (178183850)
Podcasts
Resolved Issues
Fixed: On first launch after updating, you might experience longer-than-expected library migration times, which might last several minutes. (175524004)
RealityKit
New Features
The Gaussian Splat Component API in RealityKit will be available in an upcoming release. (178061856)
Resolved Issues
Fixed:
ComputeGraphComponentsstored in a Reality file do not render when loaded. (177674901)Fixed: When
OpacityComponentis applied to an entity with opaque materials,RealityRendererrenders the opaque materials with transparency, revealing interior surfaces. Only the frontmost surface should appear with partial transparency. (177976245)
Known Issues
Some MaterialX 1.39 nodes are not supported. (172875414)
Related Receipts
Known Issues
The disclaimer “Siri found in Mail or Photos. Not shared with card issuer” does not appear below displayed transaction related receipts in Wallet for Apple Pay, Apple Card, and Apple Cash. (178202101)
Reminders
Known Issues
After you tap “Add to Reminders” in Messages, the “New Reminder” interface presents the reminder with an empty title field. (180040003)
Workaround: Tap “Add to Reminders” in the “New Reminder” interface to create the reminder, then edit the title in the Reminders app.
Safari
Resolved Issues
Fixed: The Safari tab bar might enter a state where it does not appear on screen. (177812052)
Fixed: Safari Intelligence features might appear as available before assets are fully downloaded. If you use the feature before assets are available, it won’t function correctly. (178099724)
Fixed: On iPad, the tip prompting users to automatically organize their tabs might not appear in Safari. (178280800)
Safari Extensions
Resolved Issues
Fixed: Turning on or off Safari extensions created via the “Describe an Extension” feature might not take effect until Safari is relaunched. (179293939)
Screen Time
Resolved Issues
Fixed: Screen Time restrictions might not apply to child accounts despite being configured. (175437403)
SensorKit
Resolved Issues
Fixed: PPG sensor reader might return no samples when attempting to fetch data. (178275291)
ShaderGraph
Resolved Issues
Fixed: The
realitykit_hair_surfaceshadernode does not supportDiffuseLightProbeGroupComponent. Materials built with this node might not respond to diffuse light probe group lighting. (177976666)
Shortcuts
Resolved Issues
Fixed: Focus automations migrated from iOS 26 to iOS 27 do not work. (179514725)
Fixed: Writing Tools actions are unavailable in Shortcuts. (179846468)
Fixed: The Use Model action might fail to run when using the On-Device option for some output types. (181071784)
Known Issues
If an app intent uses Duration or
LPLinkMetadata, creating a shortcut with that intent and then attempting to edit it with “Describe a change” might fail. (166068090)Workaround: If the model discards the action, press “Undo” to recover the unsupported intent.
When an app intent defines a
UnionValueparameter with two number-related types (for example, both Int and Double), the number option appears twice in the parameter picker menu and shows as double-selected. (168315587)Workaround: Define only one number-related type in the
UnionValueparameter (for example, use only Int or only Double, not both).Shortcuts containing the Send Message action might fail when importing or sharing. (182745894)
Siri
Resolved Issues
Fixed: Siri ignores custom values for navigation preferences, transport, and incident types in apps that use
maps.startNavigationormaps.reportIncidentintent schemas. (175230813)Fixed: When location data is unavailable or only coarse-accuracy location data is available, Maps searches initiated through Siri might return empty or imprecise results. (175380461)
Fixed: When you ask Siri to work with reminder lists, you might need to use the exact list name. Siri might not recognize similar or partial list names. (176400964)
Fixed: App Intents with
@UnionValuetypes that accept aPlaceDescriptorEntityand aStringalways receiveStringvalues instead ofPlaceDescriptorEntityentities. (176844035)Fixed: Starting a call with Siri might fail with an error in apps that adopt CallKit and the
phone.startCallAppSchema. (177190637)Fixed: When you ask Siri to send a message to a contact that doesn’t exist on your device, Siri might draft a message to an unrelated contact. (177356158)
Fixed: You might not see names and images of email senders in the Siri email list UI. (177416168)
Fixed: Siri might not resolve some entity types when your app has provided only an
EntityStringQueryfor the entity type. (177464215)Fixed: Siri functionality during software updates is limited, including calls to emergency services. (177476889)
Fixed: Asking Siri to call short phone numbers, such as “Call 17”, might fail. (177545828)
Fixed: Search results from third-party apps may not be tappable. (177593534)
Fixed: Disabling Siri might not delete your Siri and Dictation interaction history from your device. (177649865)
Fixed: Siri might not find app-specific contacts that are only indexed in Spotlight and do not appear in the Contacts app. (177679168)
Fixed: Siri cannot create a recurring reminder or update an existing reminder to be reoccurring. (177722240)
Fixed: With AirPods connected to iPhone and Announce Notifications enabled, responding “yes” by voice or head gesture to a long incoming notification (for example, a message) prompts you to unlock iPhone instead of reading the full message aloud. (177733317)
Fixed: When you use ChatGPT with Apple Intelligence, some responses used in follow-up queries or when you resume a chat might be logged by Apple. (177755742)
Fixed: When you ask Siri to find, search, or read reminders, Siri might list or read the reminders instead of showing a snippet. When reminder lists are displayed, the list color might not appear correctly. (177762533)
Fixed: Siri might run the incorrect
OpenIntentorsystem.openintent when multiple intents targeting different entity types are available in your app. (177992979)Fixed: After creating a list through Siri, tapping the list icon might result in an error instead of opening the list in the Reminders app. (177998395)
Fixed: When you tap the Send button in the Siri message confirmation flow, the message might fail to send. (178025056)
Fixed: When you ask Siri to open a URL from the Siri App, Safari might launch to a blank screen. (178163636)
Fixed: On CarPlay with Apple Intelligence and the ChatGPT extension enabled, asking ChatGPT a question through Siri might not produce a spoken answer. The Siri orb appears briefly and the microphone reopens without Siri responding. (178247289)
Fixed: You might encounter build failures when attempting to implement a Transferable
IntentValueRepresentationforPHAsset. (178276448)Fixed: When asking Siri to call, message, or email a contact, Siri might fail to resolve the correct person — particularly when multiple contacts share the same name, when group names contain emoji or special characters, or when relationship labels (e.g., “my brother”) are ambiguous. In some cases, Siri might pick the wrong contact, fail to present a disambiguation prompt, or freeze during the disambiguation UI. (178379209)
Fixed: For Report a Concern flows started with Siri, the text in attachments might be difficult to read while in Dark Mode. (178381615)
Fixed: Businesses with overnight hours might display as “Closed till [next day]” even during open hours. (178384054)
Fixed: In CarPlay, when Apple Intelligence enabled, Siri requests for directions in Maps might fail to start navigation. (178459481)
Fixed: Siri might not respond to your voice correctly. (178489724)
Fixed: In the Siri app, conversations might be deleted a few minutes after receiving streaming responses. (178560562)
Fixed: When you say “Save Parking Location,” the parking location information displays with reduced detail compared to Beta 1. (179195692)
Fixed: When the Camera app is open, the Siri “orb” waveform will not animate correctly on some older iPads and “Hey Siri” requests might fail. Affected devices are iPad Air (5th generation, 2022), iPad mini (7th generation, 2024), iPad Pro 11-inch (3rd generation, 2021), and iPad Pro 12.9-inch (5th generation, 2021). (180751246)
Fixed: Siri encounters an error when asked to compose emails if the Mail app is not open in the background. (181041601)
Known Issues
After Siri returns photo search results and you select photos, Siri might not detect which photos are selected on screen. Commands like “Send these” might apply to all photos returned from the search rather than only the selected ones. (171728298)
Workaround: Open Photos, select the photos you want to act on, then perform the action using Siri — for example, “Send these photos to Bob”.
When you turn off Siri, some photo-related questions might return web search results instead of prompting you to share the photo with ChatGPT. (175884006)
Siri doesn’t support voice commands to interact with specific photos. For example, you can’t refer to photos by number, such as “photo one” or “photo four.” (176812955)
Workaround: Use the photo picker to select the photo you want, or tap to select photos directly.
When you ask Siri for Maps information, the response snippets might appear incomplete or display formatting issues. (177116121)
Workaround: Ask Siri to repeat the information, or open Maps directly for complete details.
When you ask Siri to add photos to an album, the confirmation prompt and spoken response might report or display more photos than will actually be added. (177376984)
Workaround: Add photos to the album manually in the Photos app: tap Select, tap the photos you want to add, tap the Share button, tap Add to Album, then tap the album.
New American English Siri voices 6 and 7 might default to legacy US voices when your device is overheated or in Low Power Mode. (177742977)
Workaround: Turn off Low Power Mode or wait for your device to cool down.
After enabling Expressive Voices, you are not able to modify Pace or Expressiveness in the Settings pane. (177969955)
Non-SF Symbol custom images for entities might not appear in Siri results for third-party apps. (177984074)
When you ask Siri to read your last message, Siri might read an unread message from an unknown sender, such as spam, instead of the most recent message from a known contact. (178049066)
Workaround: Name the sender in your request – for example, “Read my last message from .”
Siri might respond more slowly than expected in CarPlay, particularly under higher device temperatures or poor network conditions. (178274714)
Workaround: Try the request again after the device has cooled down or once you are in an area with better cellular reception.
Siri might cut off the end of words during navigation. (181266301)
Workaround: Reduce voice expressivity from the fastest pace, or turn off expressive voices.
Siri AI
Resolved Issues
Fixed: On macOS, Siri AI cannot search within specific folders such as Desktop or Documents. File searches might return results from unintended locations. (180333394)
Siri, Spotlight, and Mail App Search
Resolved Issues
Fixed: Mail older than 6 months might not be searchable by body content, but is still searchable by sender and subject. (177942110)
Sleep Focus
Resolved Issues
Fixed: Sleep Focus may not automatically toggle on/off after a reboot or update until the user unlocks the device. (179960164)
StandBy
Resolved Issues
Fixed: StandBy Clocks may be missing. (178061326)
Status Bar
Known Issues
Status bar might appear blurred while apps are in the foreground. (179470940)
Workaround: Restart your iPhone.
StoreKit
New Features
Offer code redemption APIs now return a
VerificationResultwhen redemption completes. If a redemption succeeds, your app receives aVerificationResultthat contains aTransactionobject. If a redemption fails, your app receives an error that describes what caused the redemption to fail. (141012819)StoreKit now includes the
Transaction.OwnershipType.assignedandTransaction.RevocationType.assignmentRevokedenum values to support volume purchases.Transactionquery methods now additionally return transactions assigned to the Managed Apple Account. (156749517)New
Product.ProductTypeAPIs represent subscription Bundles and subscription Suites. New APIs inProduct.SubscriptionInfo.BundledSubscriptionlet you fetch merchandising data about subscriptions contained in a Bundle. Transaction and RenewalInfo contain new fields that provide information about purchases and customer status regarding Bundles and Suites. (160501742)partnerNameandpartnerIdproperties for Advanced Commerce API are available in Transaction.AdvancedCommerceInfo and RenewalInfo.AdvancedCommerceInfo. (167808780)
Known Issues
The refund request, offer code redemption, and manage subscriptions sheets might fail to present in TestFlight. (180999342) (FB23487953)
Purchases of non-subscription In-App Purchases made using the SKTestSession.buyProduct() method might fail with an invalid product error. The billingPlanType(_:) PurchaseOption isn’t respected for subscription purchases. (181842500)
StoreKit Testing in Xcode
Resolved Issues
Fixed: The unified app receipt is not updated after forcing a subscription expiration with
SKTestSession. (102093015) (FB11767567)Fixed: The
SKTestSessiondisableDialogssetting is not always respected for all system dialogs. (154390284) (FB18403150)Fixed: Subscription upgrades performed with the Xcode Transaction Manager are not reported in
Transaction.updates. (160698598) (FB20269723)Fixed: The renewal behavior preference is not respected when using the
purchaseDate(_:renewalBehavior:)purchase option to make purchases usingSKTestSession. (162014134) (FB20537538)Fixed: Re-purchasing a previously refunded non-consumable fails with an already owned error when using StoreKit Testing in Xcode. (174560379) (FB22475017)
Fixed: Using
pricingTerms.commitmentInfo.pricein StoreKit Testing in Xcode returns an incorrect price for monthly subscriptions with a 12-month commitment. (177942756)Fixed: Transactions for upgraded subscriptions are immediately marked as expired when using StoreKit Testing in Xcode. (178441109)
Suggestions in Messages
Resolved Issues
Fixed: The app icon shown for navigation suggestions is always the Apple Maps icon. If the suggestion is selected, the user’s preferred navigation app is correctly launched. (178193147)
Swift Charts
Resolved Issues
Fixed: When your project has a minimum deployment target lower than 27.0, using conditionals inside a
Chartclosure produces the warning “Conformance of_ConditionalContent<TrueContent, FalseContent>toChartContentis only available in ‘’ 27.0 or newer,” and the app might crash at runtime when that content is loaded. (174168981)
SwiftData
Resolved Issues
Fixed: You might experience a deadlock for @Query when saving a ModelContext on a background actor while scheduling new async tasks for a ModelActor. (178113288)
SwiftUI
New Features
You can now use
.toolbarColorScheme(colorScheme, for: .statusBar)to set a preferred status bar color scheme. (55162154) (FB7234376)AsyncImagenow automatically caches downloaded images using HTTP caching protocols, allowing servers to control caching behavior via standard headers. You can customize caching for specific images using the newAsyncImageinitializers that acceptURLRequestwith customcachePolicysettings. Additionally, you can set a customURLSessionusing the newView.asyncImageURLSession(_:)API to control how all childAsyncImageviews perform data tasks. (78212597)In apps built with the iOS 27.0 and iPadOS 27.0 SDKs, a
Textview with.textSelection(.enabled)applied now supports user-interactive selection using the system text selection UI. Previously, selectableTextviews on iOS and iPadOS offered selection functionality through a callout menu. When building with the iOS 27.0 and iPadOS 27.0 SDKs, selectableTextviews might include additional gestures for system text selection interactions. Consider using.highPriorityGesture()for custom gestures applied toTextviews that should supersede system text selection gestures. (79770704) (FB9208920)A
@Statedeclared with an expression as its initial value used to evaluate the expression each time the view struct re-instantiates. In the case of@State private var model = Model(), this meansModel.init()gets called many times throughout the view’s lifetime. Xcode 27 introduces a new@Stateimplementation that avoids this repeated evaluation. This new behavior back-deploys to iOS 17 aligned OSes. The new@Stateis implemented with a Swift macro. It is largely source compatible with the property wrapper version, with a few exceptions.If you provide an initial value at
@Statedeclaration, and also try to assign a value to it in an initializer, the initializer value is discarded. This behavior has not changed because of the macro, but some such cases no longer compile:struct StickerPageView: View { @State private var page = StickerPage() let title: String init(title: String) { // `title` won't have any effect // this also won't compile with @State macro self.page = StickerPage(title: title) self.title = title } }When assigning initial value via an initializer, do not provide an initial value at the @State declaration.
struct StickerPageView: View { @State private var page: StickerPage // no initial value expression let title: String init(title: String) { self.page = StickerPage(title: title) // works! self.title = title } }When all stored members of a struct are private, the compiler synthesizes a private init that can be used in an extension of the same type:
struct StickerPageView: View { @State private var page: StickerPage private let title: String ... } extension StickerPageView { init(title: String, _ page: StickerPage) { self.init(page: page, title: title) // using the synthesized init } }The state macro disables this synthesized initializer. So the code above no longer compiles. To mitigate, assign value to members explicitly:
extension StickerPageView { init(title: String, _ page: StickerPage) { self.title = title self.page = page } }In rare situations, the automatic inference of generic arguments of
@Stateis less flexible with the macro implementation. Write the type with more specificity.Composing
@Statewith other property wrappers or macros is not supported. (105893279)In apps built with the iOS 27.0 and macOS 27.0 SDKs, selectable
Textviews now supportTextRenderer. (158160386) (FB19589465)In apps built with the 27.0 SDKs, the new
ReadableDocumentandWritableDocumentprotocols support asynchronous reading and writing, progress reporting, and direct access to document URLs. NewDocumentGroupinitializers that adopt these protocols let you disable document creation for editing-only apps and present custom UI before any document is opened. The initializers expose anObservableURLDocumentConfigurationand integrate with Swift concurrency and theObservationframework. New applications should preferReadableDocumentandWritableDocumentoverReferenceFileDocument, which remains available. (158441552)In apps built with the iOS 27.0 and iPadOS 27.0 SDKs, a
TabViewenforces that its selection is set to a visible tab.TabViewmight crash when its selection is set to a hidden or otherwise unavailable tab. (164516837)You can use
.toolbarVisibility(hideStatusBar ? .hidden : .automatic, for: .statusBar)to conditionally hide the status bar. (165329279)The menu bar on iPadOS 27.0 and macOS 27.0, as well as context menus on macOS 27.0, present a reduced set of menu item images. By default, SwiftUI now hides all menu item symbol images in most contexts, while non-symbol images remain visible. Review the updated Human Interface Guidelines to determine which menu items in your app should still display images. Use the
labelStyle(_:)view modifier with the.titleAndIconstyle to indicate that a menu itemLabel’s icon should always be shown — such as when the menu item represents an object or a concept rather than an action. SwiftUI continues to automatically provide default visible menu item images for certain common system-wide menu items, such as Settings, Share, and Print. (170480710)The
TabsPickerStylestyle is now available for pickers that represent tab-based navigation and content selection. This style is similar to the.segmentedstyle, but VoiceOver reads it as “tabs,” and on macOS it has a distinct visual appearance that distinguishes it from pickers that represent value selection — for example, a text alignment picker in an inspector. (173211711)You can now use the
TextInputBorderShapetype to customize the border shape of text input controls likeTextFieldwith thetextInputBorderShape(_:)view modifier. The.squareBorderand.roundedBordertext field styles are soft deprecated — use the new.borderedtext field style instead. (173362083)In apps built with the iOS 27.0 SDK, you can display non-interactive content on external display scenes using the
.sceneAccessoryview modifier with anExternalNonInteractiveAccessorytype. (175548901)In apps built with the 27.0 SDKs, a
LabeledContentview used inside aMenumaps its value to the platform menu item’s subtitle. (175594929)The @Entry macro now warns of potential issues if you store default class instances or closures in the environment. The SwiftUI Specialist skill in Xcode provides guidance for resolving these issues. (175902616)
You can now access
concentricCornerRadiiandconcentricCornerRadii(in:)onGeometryProxy. These APIs return the corner radii that are concentric with the view’s container shape as aRectangleCornerRadii?. You can use these values to drive custom drawing or layout that responds to the container’s corners without rendering aConcentricRectangledirectly. (177185166)You can now use the
Documentprotocol for representing documents inDocumentGroup. This protocol combinesReadableDocumentandWritableDocumentfor common read-and-write cases. UseDocumentinstead ofReferenceFileDocumentandFileDocument, which are now deprecated. (177458781)@ContentBuildertype checking performance is further improved for valid code compared to Beta 1. (177526032)You can use
toolbarMinimizationBehaviorto control bar minimization behavior. This modifier replacestoolbarMinimizeBehavior. (177954148)The new data item or error object based
alertandconfirmationDialogmodifiers can now be used by projects targeting iOS 15.0, macOS 12.0, tvOS 15.0, watchOS 8.0, and visionOS 1.0. (179388848)In macOS apps built with the macOS 27 SDK, the action retrieved from the
\.newDocumentenvironment value accepts an in-memoryReadableDocumentproduced by an autoclosure. SwiftUI presents a new document window populated with the supplied instance, instead of invoking the document group’s default factory. Use this to implement “New from Template” commands and similar flows. (180300890)A new
fileExporter(isPresented:documents:contentTypes:onCompletion:onCancellation:)modifier exports a collection of values that conform toWritableDocumentwhoseWriter.DestinationisURL. The system presents a single export dialog, writes each document to the chosen destination, and reports the resulting URLs throughonCompletion. (180301165)The
makeFileWrapperclosure ofFileWrapperDocumentWriternow receives a second argument,previous: FileWrapper?, holding theFileWrapperfrom the document’s most recent read or write when one is available. Package documents can mutatepreviousin place and return it so thatFileWrapperonly writes children whose contents changed, avoiding rewriting an entire package on every save. Documents stored as a single file can ignore the second argument and return a freshFileWrapperas before. Existing call sites must update their closures to accept the new parameter. (180301399)DocumentReader.SourceandDocumentWriter.Destinationnow default toURL. Conforming types that read from or write to a file URL no longer need to declaretypealias Source = URLortypealias Destination = URL. (180301692)
Resolved Issues
Fixed: In apps built with the 2027 SDKs, tapping the status bar to scroll a
ScrollViewto its top correctly updates a boundscrollPosition. Previously, the binding could be left holding a stale value because the scroll-to-top transition didn’t drive the scroll-phase updates that propagate to the binding. (111501113) (FB12477370)Fixed: A custom
TextRendererapplied via.textRenderer(_:)now takes effect on aTextview that also has.textSelection(.enabled)applied. Previously, the custom renderer was dropped on selectable text, falling back to default rendering. (151015350)Fixed: When you apply both
.fileExporter(_:...)and.fileMover(_:...)modifiers to a view, some dialogs might not present correctly. (154080867)Fixed: In apps built with the 27.0 SDKs,
containerRelativeFrame(_:alignment:)incorrectly accounts for safe-area insets on aScrollView’s non-scrollable axis, causing the calculated scrollable content size to be too small. For example, a view usingcontainerRelativeFrame(.vertical)inside a horizontalScrollViewextends into vertical safe-area regions, such as the navigation bar and home indicator, because only the scrollable axis insets are applied. (165913417)Fixed: Retroactive conformances of SwiftUI types to Equatable are not consulted when SwiftUI compares their values. (167443223)
Fixed: Certain control-related view modifiers unexpectedly affect sheet and popover content. In apps built with the 27.0 SDKs, the
controlSize,buttonSizing,buttonRepeatBehavior,menuIndicatorVisibility, andButtonBorderShapeenvironment values are now reset to their default values in sheets and popovers. (167448274)Fixed:
Menulabels cannot contain controls, views with gestures, or view representables with gesture recognizers. (169091260)Fixed: A Button containing both an icon and a title placed inside a
ListSectionheader or footer has incorrect spacing between its icon and title. (175681345)Fixed: When you present a
fullScreenCoverwith a.navigationTransition(_:)and set@FocusStatetotruevia.onAppear, the keyboard does not animate concurrently with the zoom transition. Instead, it waits for the entire zoom animation to complete before the keyboard begins animating up, resulting in a visually jarring 2-step animation. (178421089)Fixed:
@Statevariable named using a raw identifier fails to compile. (179149051) (FB23015259)The
read(from:progress:)andwrite(content:to:previous:progress:)requirements ofDocumentReaderandDocumentWriterare declared with@concurrentinstead ofnonisolated. With approachable-concurrency defaults that inferMainActorisolation, an unannotatednonisolatedasync method runs on the main actor, defeating the intent of off-main reading and writing. Conforming types that previously usednonisolatedshould switch to@concurrentto match. (180302015)The
makeDocument:andmakeReadableDocument:closures passed toDocumentGroupinitializers are now@MainActor-isolated. SwiftUI invokes these factories on the main actor when constructing a document instance, allowing the closure body to access main-actor state — including the suppliedURLDocumentConfiguration— without hopping isolation domains. (180302065)URLDocumentConfigurationis a@MainActor-isolated@Observablereference type and no longer conforms toSendable. Code that captured a configuration in aSendableclosure or stored it in aSendablevalue should drop the constraint and access the configuration on the main actor. (180302075)
Known Issues
Progress reported in
DocumentReader.read(from:progress:)andDocumentWriter.write(snapshot:to:previous:progress:)might not be presented. (158441261)
Deprecations
The
FileDocumentprotocol is deprecated. UseReadableDocumentfor read-only documents orDocumentfor documents that support reading and writing. (178776840)
System
New Features
System now provides Swift APIs for the C
stat,lstat,fstat, andfstatatsystem calls. This includes a newStattype with initializers fromFilePath,FileDescriptor, or a C string;FilePath.stat()andFileDescriptor.stat()instance methods; and supporting types (FileType,FileMode,FileFlags,UserID,GroupID,DeviceID, andInode). See SYS-0006 for more details. (160612181)
Resolved Issues
Fixed: Custom
FilePathorFileDescriptorextensions that make unqualified calls tostat()orstat(_)(without theDarwin.qualification) might conflict with the new Swiftstat()instance methods introduced in SYS-0006, causing build errors. See SYS-0008 for more details. (177911316)
System Experience
Resolved Issues
Fixed: When Siri is off and your iPad is extended to an external display where Spotlight is on screen, disconnecting the display might cause the system to crash. (176281601)
Fixed: After using iPhone Mirroring or other non-main display experiences, a black pill may appear on the CarPlay screen. (177893758)
System Stability
Resolved Issues
Fixed: Devices might freeze or panic when idle. (178343305)
TextKit
New Features
NSTextTableand its related objects and types are available to UIKit clients starting with OS 27 releases. (159870239)
Trust Insights
New Features
You can now use the TrustInsights framework in your apps by declaring the TrustInsights capability on your app target in Xcode. The framework requires an entitlement and internet connectivity to return results. (154949256)
UIKit
New Features
When linked on iOS 27, tvOS 27, macCatalyst 27, or visionOS 27 SDKs, you can use
UIScene.extendStateRestorationandUIScene.completeStateRestorationto extend state restoration forUIScene.ActivationState.backgroundtoUIScene.ActivationState.foregroundlifecycle transitions. (161843040)iOS and iPadOS apps built with the 27.0 SDK or later are required to include a launch screen. Your app’s
Info.plistmust contain one of the following keys:UILaunchStoryboardName,UILaunchStoryboards,UILaunchScreen, orUILaunchScreens. Apps that don’t include a launch screen are rejected when the App Store begins accepting apps built with the 27.0 SDK. (168247372)On iOS 27.0 and iPadOS 27.0, Siri can load resources from drag interactions installed in your app’s interface. For example, when Apple Intelligence is invoked from a context menu, the system calls
UIDragInteractionDelegatemethods to load the content. Because drag sessions might begin without a user-initiated drag gesture, avoid performing animations or presenting modal UI for the drag indragInteraction(_:sessionWillBegin:). Instead, perform those actions indragInteraction(_:sessionDidMove:). (168884200)In apps built with the iOS 27.0 SDK, a presented view controller inherits its trait collection by walking up its view’s superview chain through the intermediate views of the presentation, rather than jumping directly to the presentation controller. Custom
UIPresentationControllersubclasses or view controllers that depend on receiving traits directly from the presentation controller might need to update how they propagate or overridetraitCollection. (170005251)On iPadOS 27.0 and macOS 27.0, the menu bar and context menus present a reduced set of menu item images and do not display images set on menu elements by default. You can use the new
preferredImageVisibilityproperty onUIMenuElement— including updated initializers onUIMenu,UIAction,UICommand, andUIKeyCommand— to customize the visibility of each element’s image in these menus. Review the updated Human Interface Guidelines to determine which menu elements in your app should display images. UIKit automatically provides default visible menu element images for certain common system-wide menu items, such as Settings, Share, and Print. (170479084)In apps built with the iOS 27.0 SDK, when
UISearchControlleruses center search-bar placement, the scope bar appears inline on the same row as the search field rather than on a separate row beneath it. When the search field is hosted inside a navigation bar, the scope bar sits inline beside the search field within that navigation bar. (173860616)In apps built with the iOS 27.0 SDK,
windowExternalDisplayNonInteractivescenes are no longer offered automatically by the system. UseUIViewController.registerSceneAccessory(_:)with aUISceneAccessory.externalNonInteractiveinstance to display non-interactive content on external display scenes. (177015874)Use
UINavigationItem.navigationBarMinimizationto control navigation bar minimization behavior. This property replacesUINavigationItem.barMinimizeBehaviorandUINavigationItem.barMinimizationSafeAreaAdjustment. (177953926)The container view of a
UIScrollEdgeElementContainerInteractionmay contribute its size and position to the overall shape of the scroll edge effect. (179191941) (FB23027596)
Resolved Issues
Fixed: In apps built with the iOS 27.0 SDK, the deprecated status bar accessors on
UIApplication— includingstatusBarFrame,statusBarOrientation,statusBarStyle, andisStatusBarHidden— might return NaN or null values. (162044221)Fixed: The
UISceneClosureConfirmationAPI does not present a confirmation dialog. (169108042)Fixed: The
UIMenuLeafprotocol is missing the subtitle property introduced in iOS 16.0. (173271862)Fixed: The background might not appear on a bottom toolbar when you use
UIBarButtonItem.hidesSharedBackgroundto hide a toolbar item’s glass background. (174773785)Fixed: On iPad, if your iPad app is built with the iOS 27 SDK and sets
UIRequiresFullScreen, the bounds ofUIScreen.mainchanges when the user resizes the window. The bounds of the main screen should remain fixed once the screen connects. (178559386)
Known Issues
On iPad, if your iPad app is built with the iOS 27 SDK and its
UISupportedInterfaceOrientationsdoesn’t include all four interface orientations, the app is treated as non-continuously resizable. Beginning with iOS 27, supported interface orientations should no longer be a condition for continuous resizability. (166422120)Workaround: To make your app continuously resizable on iPad, declare support for all four interface orientations in your
Info.plistwithUISupportedInterfaceOrientations.In iPhone Mirroring, if your app is built with the iOS 27 SDK its scene will support all interface orientations regardless of the orientations declared in
UISupportedInterfaceOrientationsor returned byUIViewController.supportedInterfaceOrientations. Supported interface orientations should be honored until the user begins resizing the window. (178555304)In iPhone Mirroring, if your app is built with the iOS 27 SDK and sets
UIRequiresFullScreen, its scene receives continuous resize updates when the user resizes the window. Each resize should instead be delivered as a discrete change to a newUIScreenwith an updated bounds. (178558224)In iPhone Mirroring if your app is built with the iOS 27 SDK, its scene is initially connected to a
UIScreenthat isn’tUIScreen.main. The scene should start on the main screen. (178558897)On iPad, if your iPad app is built with the iOS 27 SDK and sets
UIRequiresFullScreen, its scene receives continuous resize updates when the user resizes the window. Each resize should instead be delivered as a discrete change to a newUIScreenwith an updated bounds. (178560235)On iPad, if your iPhone-only app is built with the iOS 27 SDK its scene continues to honor supported interface orientations after the user resizes the window. After the first resize, the scene should ignore supported interface orientations. (178561952)
On iPad, if your iPhone-only app is built with the iOS 27 SDK and sets
UIRequiresFullScreen, its scene receives continuous resize updates when the user resizes the window. Each resize should instead be delivered as a discrete change to a newUIScreenwith an updated bounds. (178562971)On iPad, if your iPhone-only app is built with the iOS 27 SDK and supports only portrait or only landscape interface orientations, its layout breaks when the iPad is in an orientation the app doesn’t support. (178573319)
Deprecations
Apps built with the latest SDK must adopt the scene-based life cycle or they fail to launch. For migration guidance, see Transitioning to the UIKit scene-based life cycle. (141837548)
canOpenURL:is deprecated. Attempt to open the URL and handle any failure instead of validating it first. Using universal links instead of custom URL schemes removes the need for this validation entirely. (179874781)
USDKit
Resolved Issues
Fixed: Some types of USD attributes cannot be read or modified. (170653056)
Fixed: Array, vector, matrix, and quaternion types cannot be authored using USDKit. (178071414)
VideoToolbox
New Features
VTLowLatencySuperResolutionScalerConfigurationnow supports a 1.5x scale factor. Call+supportedScaleFactorsForFrameWidth:frameHeight:to discover the scale factors available for your source dimensions. (177635243)VTLowLatencyFrameInterpolationConfigurationnow supports arbitrary source dimensions up to 1080p. (179040806)
Watch Connectivity
Resolved Issues
Fixed: The
WCSession.transferCurrentComplicationUserInfomethod does not work with complications built using WidgetKit on watchOS. (113202790) (FB12819178)
Weather Highlights
Known Issues
Weather Highlights is currently only available in US English. (164408676)
WidgetKit
Resolved Issues
Fixed: Your widget extension might not render its timeline when it uses an App Intent with a
@UnionValueparameter, and content such as images might not appear. This affectsWidgetConfigurationIntenttypes that you declare with a@UnionValueproperty. (177493357)
Writing Tools
Known Issues
Writing Tools becomes unresponsive when you interact with the Plus button while Writing Tools is in use. (177097101)
Workaround: Force quit Messages to resolve the issue.
Xcode
Resolved Issues
Fixed: The Simulator might display a black wallpaper and blank app icons temporarily during first boot. (179746601)