<!--
{
  "documentType" : "article",
  "framework" : "Updates",
  "identifier" : "/documentation/Updates/watchos",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "watchOS updates"
}
-->

# watchOS updates

Learn about important changes to watchOS.

## Overview

Browse notable changes in <doc://com.apple.documentation/documentation/watchOS-Apps>.

## September 2024

### Watch sizes

- Apple Watch Series 10 are larger and have a different aspect ratio than previous watches. The watch is 1mm larger than the Series 9 (42mm and 46mm), but the screen gains more width than height. Use <doc://com.apple.documentation/documentation/SwiftUI/View/scenePadding(_:)> to align text with the text margins, and <doc://com.apple.documentation/documentation/SwiftUI/View/ignoresSafeArea(_:edges:)> to extend content beyond the watch’s safe area.

### Shallow dives

- Apple Watch Series 10 supports the Shallow Depth and Pressure capability. Use <doc://com.apple.documentation/documentation/CoreMotion/CMWaterSubmersionManager> to start a shallow dive session, and <doc://com.apple.documentation/documentation/HealthKit/HKQuantityTypeIdentifier/underwaterDepth> and <doc://com.apple.documentation/documentation/HealthKit/HKQuantityTypeIdentifier/waterTemperature> to read depth and temperature samples from HealthKit.

## June 2024

### Water temperature

- Access water temperature data from swimming workouts. Apple Watch Ultra records <doc://com.apple.documentation/documentation/HealthKit/HKQuantityTypeIdentifier/waterTemperature> samples during swimming workouts.

### Double tap

- Specify which control responds to the double tap gesture using the <doc://com.apple.documentation/documentation/SwiftUI/View/handGestureShortcut(_:isEnabled:)> view modifier, passing <doc://com.apple.documentation/documentation/SwiftUI/HandGestureShortcut/primaryAction> as the parameter. Double tap can interact with any buttonlike controls, such as buttons or toggles.

### Creating workouts

- Create custom pool swimming workouts with the <doc://com.apple.documentation/documentation/HealthKit/HKWorkoutActivityType/swimming> activity.
- Set a distance-with-time goal for custom swimming workouts with the <doc://com.apple.documentation/documentation/WorkoutKit/WorkoutGoal/poolSwimDistanceWithTime(_:_:)> goal.
- Provide a custom name to a workout step using the <doc://com.apple.documentation/documentation/WorkoutKit/WorkoutStep> structure’s <doc://com.apple.documentation/documentation/WorkoutKit/WorkoutStep/displayName>.
- Preview workouts on Apple Watch using the <doc://com.apple.documentation/documentation/SwiftUI/View/workoutPreview(_:isPresented:)> view modifier.
- Set average power goals for cycling and running with <doc://com.apple.documentation/documentation/WorkoutKit/PowerThresholdAlert> and <doc://com.apple.documentation/documentation/WorkoutKit/PowerRangeAlert>.
- Set pace goals for indoor running with the <doc://com.apple.documentation/documentation/WorkoutKit/SpeedThresholdAlert> and <doc://com.apple.documentation/documentation/WorkoutKit/SpeedRangeAlert> targets.

## September 2023

- When someone performs a Double Tap gesture while viewing
  a notification on Apple Watch Series 9 or Apple Watch Ultra 2,
  the system invokes the first nondestructive action. A nondestructive action doesn’t include the
  <doc://com.apple.documentation/documentation/UserNotifications/UNNotificationActionOptions/destructive>
  option, and won’t delete user data or change the app irrevocably.

## June 2023

- Use the new watchOS user interface design to simplify navigation, better use the Digital Crown, and enrich the app experience. For more information, see <doc://com.apple.documentation/design/Human-Interface-Guidelines/designing-for-watchos> and <doc://com.apple.documentation/documentation/watchOS-Apps/creating-an-intuitive-and-effective-ui-in-watchos-10>.
- Update your WidgetKit-based complications to take advantage of the Smart Stack on Apple Watch. People can scroll down to see relevant widgets directly on the watch face using the Digital Crown. For more information, see <doc://com.apple.documentation/documentation/WidgetKit/Widget-Suggestions-In-Smart-Stacks>.
- Use curved text along the bevel or around the corners in WidgetKit-based complications.
- Add state preservation and restoration to watchOS apps. For more information, see <doc://com.apple.documentation/documentation/UIKit/preserving-your-app-s-ui-across-launches>.
- Use WorkoutKit to create goal, pacer, multisport, and fully custom interval workouts. Display a preview of the workout that shows the workout details, and sync workouts with a paired Apple Watch. For more information, see   <doc://com.apple.documentation/documentation/WorkoutKit>.
- Access batches of high-frequency accelerometer and device motion data during workouts. Use this data to analyze motion — such as a golf or baseball swing — after the action occurs. For more information, see <doc://com.apple.documentation/documentation/CoreMotion>.
- Use Core Motion’s water submersion manager to monitor shallow dives on Apple Watch Ultra. For more information, see <doc://com.apple.documentation/documentation/CoreMotion>.
- Support Bluetooth cycling sensors. People can pair power, cadence, and speed sensors to Apple Watch to enhance their cycling workouts. You can access this data using HealthKit for live and historical workouts.

---

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)