<!--
{
  "documentType" : "article",
  "framework" : "visionOS Release Notes",
  "identifier" : "/documentation/visionOS-Release-Notes/visionos-2_1-release-notes",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "visionOS 2.1 Release Notes"
}
-->

# visionOS 2.1 Release Notes

Update your apps to use new features, and test your apps against API changes.

## Overview

The visionOS 2.1 SDK provides support for developing apps for Apple Vision Pro devices running visionOS 2.1. The SDK comes bundled with Xcode 16.1, available from the Mac App Store. For information on the compatibility requirements for Xcode 16.1, see [Xcode 16.1 Release Notes](/documentation/Xcode-Release-Notes/xcode-16_1-release-notes).

### Apple Music

#### Resolved Issues

- Fixed: Apple Music songs and music videos may fail to play.  (137634483) (FB15445431)

### Keynote

#### Known Issues

- Presenter controls are inaccessible or difficult to access while presenting. This issue impacts the ability to bring up the Light Table to navigate to a different slide, bring up the Drawing Tools and Presenter Display, access the Live Video source, access the presenters list when using Multi-Presenter, enable/disable Auto Dimming, access the Slideshow Tips and advance the presentation/go back a slide.  (134967350)
  
  **Workaround:** Tap to advance the presentation. Long press then swipe to the right to go back a slide. Access the Slideshow Tips using Keynote Help via the Help menu in the app toolbar.

### RealityKit Graphics

#### Known Issues

- When a translucent SwiftUI view and translucent `ModelEntity` are positioned at the same point in space using `RealityViewAttachment`, a visual flickering may occur.  (135906908)
  
  **Workaround:** Add a `ModelSortGroupComponent` to the ModelEntity and set its `group` using [ModelSortGroup.PlanarUIPlacement](https://developer.apple.com/documentation/realitykit/modelsortgroup/planaruiplacement-swift.enum?changes=_9)

### StoreKit

#### Resolved Issues

- Fixed: In StoreKit Testing in Xcode, the offer identifier in the subscription renewal info might be reported incorrectly for offer codes.  (133774710)

### Swift Charts

#### Resolved Issues

- Fixed: Any project that utilizes Swift Charts fails to build when targeting iOS, macOS, or visionOS.  (135905498)

### SwiftUI

#### Resolved Issues

- Fixed: Scene restoration launches the incorrect scene.  (132497400)
- Fixed: On iOS, tvOS, and visionOS, `View.navigationSplitViewColumnWidth` (all overloads) does not produce an effect if applied after the `NavigationSplitView` is created.  (135434989)
- Fixed: Using `if #available` in @WidgetBundleBuilder and @SceneBuilder crashes on prior OS versions due to “unknown OS version.”  (136098106)

### Voice Memos

#### Resolved Issues

- Fixed: Users are unable to rename a voice memo while recording.  (136603559)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)