<!--
{
  "documentType" : "article",
  "framework" : "watchOS Release Notes",
  "identifier" : "/documentation/watchOS-Release-Notes/watchos-7-release-notes",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "watchOS 7 Release Notes"
}
-->

# watchOS 7 Release Notes

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

## Discussion

The watchOS 7 SDK provides support to develop watchOS apps for Apple Watch devices running watchOS 7. The SDK comes bundled with Xcode 12, available from the Mac App Store. For information on the compatibility requirements for Xcode 12, see <doc://com.apple.documentation/documentation/Xcode-Release-Notes/xcode-12-release-notes>.

### Clock

#### Known Issues

- Kaleidoscope faces created using the Photos app on watchOS 7 beta 4 or earlier might cause your watch to repeatedly restart unexpectedly. (65224164)
  
  **Workaround:** Use the Watch app on your phone to remove the Kaleidoscope face.
- Watch faces created using watchOS 7 beta 5 and earlier are no longer compatible with watchOS. Use watchOS 7 beta 6 or later to generate new `.watchface` files. (66592614)
- If you added a Sleep complication to a Watch face in watchOS 7 beta, it might disappear after updating to watchOS 7 beta 2 or later. (63699282)
  
  **Workaround:** Add the Sleep complication again.
- The Sleep complication might appear twice in the complication picker when editing a Watch face. (64709508)
  
  **Workaround:** Remove the Sleep app, then reinstall it using App Store on your watch.

### Logging

#### New Features

- New APIs are available for using `os_log` from Swift as part of the framework <doc://com.apple.documentation/documentation/os>. A new type, <doc://com.apple.documentation/documentation/os/Logger>, can be instantiated using a subsystem and category and provides methods for logging at different levels (`Logger.debug`, `Logger.error`, `Logger.fault`).
- The <doc://com.apple.documentation/documentation/os/Logger> APIs support specifying most formatting and privacy options supported by legacy `os_log` APIs. The new APIs provide significant performance improvements over the legacy APIs. You can now pass Swift string interpolation to the `os_log` function.
  
  **Note:** The new APIs can’t be back deployed; however, the existing `os_log` API remains available for back deployment. (22539144)

### Networking

#### New Features

- <doc://com.apple.documentation/documentation/Foundation/URLSession> metrics support is now available. (29448748)

### Software Update

#### Known Issues

- You might be unable to update Apple Watch Series 3 to watchOS 7 due to limited storage. (64793483)
  
  **Workaround:** Unpair your watch, then pair it again with your phone. Set it up as a new watch rather than restoring from a backup. Use General > Software Update in the Watch app to update to watchOS 7. If you want to restore your watch from its latest backup after the update is complete, repeat these steps while choosing to restore from a backup rather than setting up as new.

### SwiftUI

#### New Features

- <doc://com.apple.documentation/documentation/SwiftUI/Color> can be converted to and from <doc://com.apple.documentation/documentation/UIKit/UIColor/cgColor>. The <doc://com.apple.documentation/documentation/SwiftUI/ColorPicker> can also now be configured with a binding to a `CGColor`. (56939085)
- Introduced <doc://com.apple.documentation/documentation/SwiftUI/ToolbarItemGroup> as a convenient way to place multiple items in a specific location of non-customizable toolbars. (64178863)
- <doc://com.apple.documentation/documentation/SwiftUI/ProgressView> now supports adding a secondary “current value label” that describes the current progress level of the task. Use the <doc://com.apple.documentation/documentation/SwiftUI/ProgressViewStyleConfiguration/label-swift.property> to describe the overall task, and the <doc://com.apple.documentation/documentation/SwiftUI/ProgressViewStyleConfiguration/currentValueLabel-swift.property> to provide more specific details about the progress of the task. (63580200)
- <doc://com.apple.documentation/documentation/SwiftUI/Image> is now redacted when the `redacted(reason:)` modifier is applied. (65047189)
- <doc://com.apple.documentation/documentation/SwiftUI/InlinePickerStyle> is now available and allows a <doc://com.apple.documentation/documentation/SwiftUI/Picker> to appear in-line with the rest of the content in its surrounding container. The style will adapt its appearance for different containers and platforms, such as individual menu items in a menu. (59868844)
- <doc://com.apple.documentation/documentation/SwiftUI/List> may now be used with <doc://com.apple.documentation/documentation/SwiftUI/ScrollViewReader>. (35471164)
- <doc://com.apple.documentation/documentation/SwiftUI/Text> gains a new initializer accepting a <doc://com.apple.documentation/documentation/Foundation/Formatter>. (63641785)
- `body` is now implicitly a <doc://com.apple.documentation/documentation/SwiftUI/ViewBuilder> and <doc://com.apple.documentation/documentation/SwiftUI/App/body-swift.property> is now implicitly a <doc://com.apple.documentation/documentation/SwiftUI/SceneBuilder>. (63606493)

---

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)