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

# watchOS 5 Release Notes

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

## Discussion

The watchOS 5 SDK provides support for developing watchOS apps for Apple Watch devices running watchOS 5. For information about new features in watchOS 5, see [What’s New in watchOS](https://developer.apple.com/watchos/whats-new/). The SDK comes bundled with Xcode 10 available from the Mac App Store. For information about Xcode 10, see <doc://com.apple.documentation/documentation/Xcode-Release-Notes/xcode-10-release-notes>.

### Networking

#### New Features

- The <doc://com.apple.documentation/documentation/Foundation/URLSession> HTTP/2 implementation has been updated to support HTTP/2 connection reuse per RFC 7540 Section 9.1.1. This requires an HTTP/2 server to present a certificate which covers more than one server hostname. The certificate may use the Subject Alternative Name extension or wildcarded domain names. In addition, <doc://com.apple.documentation/documentation/Foundation/URLSession> requires name resolution to resolve the different hostnames to the same IP address. <doc://com.apple.documentation/documentation/Foundation/URLSession> might reuse HTTP/2 connections across different domain names when these conditions are satisfied. (37507838)

#### Deprecations

- The `ftp://` and `file://` URL schemes for Proxy Automatic Configuration (PAC) are deprecated. HTTP and HTTPS are the only supported URL schemes for PAC. This affects all PAC configurations including, but not limited to, configurations set via Settings,
  System Preferences, profiles, and <doc://com.apple.documentation/documentation/Foundation/URLSession> APIs such as <doc://com.apple.documentation/documentation/Foundation/URLSessionConfiguration/connectionProxyDictionary>,
  and <doc://com.apple.documentation/documentation/CFNetwork/CFNetworkExecuteProxyAutoConfigurationURL(_:_:_:_:)>. (37811761)

### WatchKit

#### New Features

- The tint color of a <doc://com.apple.documentation/documentation/WatchKit/WKInterfaceVolumeControl> can now be set by calling the <doc://com.apple.documentation/documentation/WatchKit/WKInterfaceVolumeControl/setTintColor(_:)> method. (40565782)

#### Deprecations

- The <doc://com.apple.documentation/documentation/WatchKit/WKInterfaceController/updateUserActivity(_:userInfo:webpageURL:)> method doesn’t properly register activities. Use <doc://com.apple.documentation/documentation/WatchKit/WKInterfaceController/update(_:)> instead. (39840960)
- The <doc://com.apple.documentation/documentation/WatchKit/WKUserNotificationInterfaceController/didReceive(_:withCompletion:)> method doesn’t receive grouped updates for threaded notifications. Use <doc://com.apple.documentation/documentation/WatchKit/WKUserNotificationInterfaceController/didReceive(_:)> instead.

---

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)