<!--
{
  "availability" : [
    "watchOS: 5.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "WatchKit",
  "identifier" : "/documentation/WatchKit/WKInterfaceVolumeControl",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "WatchKit"
    ],
    "preciseIdentifier" : "c:objc(cs)WKInterfaceVolumeControl"
  },
  "title" : "WKInterfaceVolumeControl"
}
-->

# WKInterfaceVolumeControl

An interface element that provides control of the audio volume from the watch or a paired iPhone.

```
class WKInterfaceVolumeControl
```

## Overview

Configure your app’s audio source and the appearance of the volume control in your storyboard file. Use the [`WKInterfaceVolumeControl`](/documentation/WatchKit/WKInterfaceVolumeControl) instance to change the volume’s tint color at runtime.

Do not subclass or create instances of this class yourself. Instead, define outlets in your interface controller class and connect them to the corresponding objects in your storyboard file. For example, to refer to a volume control in your interface, define a property with the following syntax in your interface controller class:

```objc
@property (weak, nonatomic) IBOutlet WKInterfaceVolumeControl* myVolumeControl;
```

During the initialization of your interface controller, WatchKit creates a new instance of this class and assigns it to your outlet. At that point, you can use the object in your outlet to make changes to the onscreen control.

After selecting the volume control, the user can increase or decrease the audio’s volume using the crown. The system automatically handles changing the audio source’s volume. You cannot access or change the volume programmatically in your app.

### Interface Builder Configuration Options

Xcode lets you configure your volume control in your storyboard file. The following table lists the attributes you can configure and their meaning.

|Attribute            |Description                                                                                                                                                                                                                                                                                                                                                                                                        |
|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Controls Local Volume|The volume control’s audio source. If checked, the control affects the volume of long-form audio playing on the watch.  If unchecked, it affects the volume of audio playing on the paired iPhone. ![](spacer) You must set this value at design time. You cannot change its value programmatically.                                                                                                               |
|Tint Color           |The tint color for the volume control.  By default, the system uses the application’s tint color. ![](spacer) The system only applies the tint color to the control’s default state (when the crown is not being used to adjust the volume). ![](spacer) You can change this value programmatically using the ``doc://com.apple.watchkit/documentation/WatchKit/WKInterfaceVolumeControl/setTintColor(_:)`` method.|

## Topics

### Setting the Tint Color

[`-  setTintColor:`](/documentation/WatchKit/WKInterfaceVolumeControl/setTintColor(_:))

Sets the volume control’s tint color.

### Managing Input from the Digital Crown

[`-  focus`](/documentation/WatchKit/WKInterfaceVolumeControl/focus())

Sets the volume control as the focus for input from the Digital Crown.

[`-  resignFocus`](/documentation/WatchKit/WKInterfaceVolumeControl/resignFocus())

Removes focus from the volume control, causing it to stop receiving input from the Digital Crown.

### SwiftUI

[`-  initWithOrigin:`](/documentation/WatchKit/WKInterfaceVolumeControl/init(origin:))

Creates a volume control for use in SwiftUI.

[`Origin`](/documentation/WatchKit/WKInterfaceVolumeControl/Origin)

The source of the audio managed by the volume control.

## Relationships

### Conforms To

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

[`Hashable`](/documentation/Swift/Hashable)

[`CVarArg`](/documentation/Swift/CVarArg)

[`Equatable`](/documentation/Swift/Equatable)

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

### Inherits From

[`WKInterfaceObject`](/documentation/WatchKit/WKInterfaceObject)

---

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)