<!--
{
  "availability" : [
    "Xcode: 16.3.0 -",
    "iOS: -",
    "iPadOS: -",
    "macCatalyst: -",
    "macOS: -",
    "tvOS: -",
    "visionOS: -",
    "watchOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "XCUIAutomation",
  "identifier" : "/documentation/XCUIAutomation/XCUIRemote/Button",
  "metadataVersion" : "0.1.0",
  "role" : "Enumeration",
  "symbol" : {
    "kind" : "Enumeration",
    "modules" : [
      "XCUIAutomation"
    ],
    "preciseIdentifier" : "c:@E@XCUIRemoteButton"
  },
  "title" : "XCUIRemoteButton"
}
-->

# XCUIRemoteButton

A button on a physical remote control.

iOS, iPadOS, Mac Catalyst, macOS, visionOS, watchOS:

```
enum XCUIRemoteButton
```

tvOS:

```
enum Button
```

## Topics

### Remote buttons

[`case up`](/documentation/XCUIAutomation/XCUIRemoteButton/up)

A constant that represents the up button on a remote.

[`case down`](/documentation/XCUIAutomation/XCUIRemoteButton/down)

A constant that represents the down button on a remote.

[`case left`](/documentation/XCUIAutomation/XCUIRemoteButton/left)

A constant that represents the left button on a remote.

[`case right`](/documentation/XCUIAutomation/XCUIRemoteButton/right)

A constant that represents the right button on a remote.

[`case select`](/documentation/XCUIAutomation/XCUIRemoteButton/select)

A constant that represents the select button on a remote.

[`case menu`](/documentation/XCUIAutomation/XCUIRemoteButton/menu)

A constant that represents the menu button on a remote.

[`case playPause`](/documentation/XCUIAutomation/XCUIRemoteButton/playPause)

A constant that represents the play-and-pause button on a remote.

[`case home`](/documentation/XCUIAutomation/XCUIRemoteButton/home)

A constant that represents the home button on a remote.

[`case pageUp`](/documentation/XCUIAutomation/XCUIRemoteButton/pageUp)

A constant that represents the page up button on a remote.

[`case pageDown`](/documentation/XCUIAutomation/XCUIRemoteButton/pageDown)

A constant that represents the page down button on a remote.

[`case guide`](/documentation/XCUIAutomation/XCUIRemoteButton/guide)

A constant that represents the guide button on a remote.

[`case fourColors`](/documentation/XCUIAutomation/XCUIRemoteButton/fourColors)

A constant that represents the color functions button on a remote.

[`case oneTwoThree`](/documentation/XCUIAutomation/XCUIRemoteButton/oneTwoThree)

A constant that represents the channel-tuning button on a remote.

[`case tvProvider`](/documentation/XCUIAutomation/XCUIRemoteButton/tvProvider)

A constant that represents the TV provider button on a remote.

### Initializers

[`init?(rawValue: UInt)`](/documentation/XCUIAutomation/XCUIRemoteButton/init(rawValue:))

## Relationships

### Conforms To

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

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

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

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

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

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

---

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)