<!--
{
  "availability" : [
    "iOS: 16.0.0 -",
    "iPadOS: 16.0.0 -",
    "macCatalyst: -",
    "macOS: 13.0.0 -",
    "tvOS: 16.0.0 -",
    "visionOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "GameController",
  "identifier" : "/documentation/GameController/GCButtonElementName-swift.struct",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Game Controller"
    ],
    "preciseIdentifier" : "s:14GameController19GCButtonElementNameV"
  },
  "title" : "GCButtonElementName"
}
-->

# GCButtonElementName

The names of the button elements.

```
struct GCButtonElementName
```

## Topics

### Getting extended gamepad shoulder button names

[`leftShoulder`](/documentation/GameController/GCButtonElementName-swift.struct/leftShoulder)

The name of the left shoulder button.

[`rightShoulder`](/documentation/GameController/GCButtonElementName-swift.struct/rightShoulder)

The name of the right shoulder button.

[`leftBumper`](/documentation/GameController/GCButtonElementName-swift.struct/leftBumper)

The name of the additional left shoulder button.

[`rightBumper`](/documentation/GameController/GCButtonElementName-swift.struct/rightBumper)

The name of the additional right shoulder button.

### Getting extended gamepad trigger names

[`leftTrigger`](/documentation/GameController/GCButtonElementName-swift.struct/leftTrigger)

The name of the left trigger.

[`rightTrigger`](/documentation/GameController/GCButtonElementName-swift.struct/rightTrigger)

The name of the right trigger.

### Getting extended gamepad face button names

[`menu`](/documentation/GameController/GCButtonElementName-swift.struct/menu)

The name of the primary menu button element.

[`options`](/documentation/GameController/GCButtonElementName-swift.struct/options)

The name of the main options button element.

[`home`](/documentation/GameController/GCButtonElementName-swift.struct/home)

The name of the main menu button element.

[`a`](/documentation/GameController/GCButtonElementName-swift.struct/a)

The name for the controller’s A button.

[`b`](/documentation/GameController/GCButtonElementName-swift.struct/b)

The name for the controller’s B button.

[`x`](/documentation/GameController/GCButtonElementName-swift.struct/x)

The name for the controller’s X button.

[`y`](/documentation/GameController/GCButtonElementName-swift.struct/y)

The name for the controller’s Y button.

### Getting extended gamepad thumbstick names

[`leftThumbstickButton`](/documentation/GameController/GCButtonElementName-swift.struct/leftThumbstickButton)

The name of the left thumbstick element.

[`rightThumbstickButton`](/documentation/GameController/GCButtonElementName-swift.struct/rightThumbstickButton)

The name of the right thumbstick element.

### Getting extended gamepad back button names

Some gamepads include additional buttons or triggers on their underside. Because the number and layout of bottom buttons vary by controller, the Game Controller framework identifies them by their easy of use or position to the person’s fingers.

[`backLeftButton(position:)`](/documentation/GameController/GCButtonElementName-swift.struct/backLeftButton(position:))

Returns the name of the back left button at the specified location.

[`backRightButton(position:)`](/documentation/GameController/GCButtonElementName-swift.struct/backRightButton(position:))

Returns the name of the back right button at the specified location.

### Getting steering wheel controller names

[`pedalClutch`](/documentation/GameController/GCButtonElementName-swift.struct/pedalClutch)

The name of the controller’s clutch.

[`pedalBrake`](/documentation/GameController/GCButtonElementName-swift.struct/pedalBrake)

The name of the controller’s brake pedal.

[`pedalAccelerator`](/documentation/GameController/GCButtonElementName-swift.struct/pedalAccelerator)

The name of the controller’s accelerator pedal.

[`leftPaddle`](/documentation/GameController/GCButtonElementName-swift.struct/leftPaddle)

The name of the controller’s left paddle.

[`rightPaddle`](/documentation/GameController/GCButtonElementName-swift.struct/rightPaddle)

The name of the controller’s right paddle.

### Getting Xbox button names

[`share`](/documentation/GameController/GCButtonElementName-swift.struct/share)

The name of the Xbox share button.

### Getting arcade stick button names

[`arcadeButton(row:column:)`](/documentation/GameController/GCButtonElementName-swift.struct/arcadeButton(row:column:))

Returns the name of the arcade stick button at the specified location.

## Relationships

### Conforms To

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

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

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

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

[`GCPhysicalInputElementTypedName`](/documentation/GameController/GCPhysicalInputElementTypedName)

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

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

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

---

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)