<!--
{
  "documentType" : "article",
  "framework" : "GameController",
  "identifier" : "/documentation/GameController/extended-gamepad-input-names",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Extended gamepad input names"
}
-->

# Extended gamepad input names

Constants for names of extended gamepad elements.

## Discussion

Use these constants as the keys when accessing [`GCExtendedGamepad`](/documentation/GameController/GCExtendedGamepad) elements by name using the [`allElements`](/documentation/GameController/GCPhysicalInputProfile/allElements) property, `subscript(_:)` notation, or similar [`GCPhysicalInputProfile`](/documentation/GameController/GCPhysicalInputProfile) APIs.

## Topics

### Shoulder button names

[`GCInputLeftShoulder`](/documentation/GameController/GCInputLeftShoulder-9assr)

The name of the left shoulder button.

[`GCInputRightShoulder`](/documentation/GameController/GCInputRightShoulder-5lcq1)

The name of the right shoulder button.

[`GCInputLeftShoulder`](/documentation/GameController/GCInputLeftShoulder-3i8m0)

The name of the left shoulder button.

[`GCInputRightShoulder`](/documentation/GameController/GCInputRightShoulder-513b5)

The name of the right shoulder button.

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

The name of the additional left shoulder button.

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

The name of the additional right shoulder button.

### Trigger names

[`GCInputLeftTrigger`](/documentation/GameController/GCInputLeftTrigger-80png)

The name of the left trigger.

[`GCInputRightTrigger`](/documentation/GameController/GCInputRightTrigger-96vtj)

The name of the right trigger.

[`GCInputLeftTrigger`](/documentation/GameController/GCInputLeftTrigger-4gjmx)

The name of the left trigger.

[`GCInputRightTrigger`](/documentation/GameController/GCInputRightTrigger-6hvns)

The name of the right trigger.

### Face button names

[`GCInputButtonMenu`](/documentation/GameController/GCInputButtonMenu-196mn)

The name of the primary menu button element.

[`GCInputButtonHome`](/documentation/GameController/GCInputButtonHome-7xxwm)

The name of the home or logo button element.

[`GCInputButtonOptions`](/documentation/GameController/GCInputButtonOptions-84kj)

The name of the secondary menu button.

[`GCInputButtonA`](/documentation/GameController/GCInputButtonA-8z15w)

The name for the controller’s A button.

[`GCInputButtonB`](/documentation/GameController/GCInputButtonB-6z361)

The name for the controller’s B button.

[`GCInputButtonX`](/documentation/GameController/GCInputButtonX-32i2z)

The name for the controller’s X button.

[`GCInputButtonY`](/documentation/GameController/GCInputButtonY-9x9i9)

The name for the controller’s Y button.

[`GCInputButtonMenu`](/documentation/GameController/GCInputButtonMenu-83i52)

The name of the primary menu button element.

[`GCInputButtonHome`](/documentation/GameController/GCInputButtonHome-8qxo4)

The name of the home or logo button element.

[`GCInputButtonOptions`](/documentation/GameController/GCInputButtonOptions-52c9a)

The name of the secondary menu button.

[`GCInputButtonA`](/documentation/GameController/GCInputButtonA-a2w2)

The name for the controller’s A button.

[`GCInputButtonB`](/documentation/GameController/GCInputButtonB-a2w1)

The name for the controller’s B button.

[`GCInputButtonX`](/documentation/GameController/GCInputButtonX-a2wr)

The name for the controller’s X button.

[`GCInputButtonY`](/documentation/GameController/GCInputButtonY-a2wq)

The name for the controller’s Y button.

### Directional pad names

[`GCInputDirectionPad`](/documentation/GameController/GCInputDirectionPad-115st)

The name of the directional pad element.

[`GCInputDirectionPad`](/documentation/GameController/GCInputDirectionPad-8igy2)

The name of the directional pad element.

### Thumbstick names

[`GCInputLeftThumbstick`](/documentation/GameController/GCInputLeftThumbstick-3hlff)

The name of the left thumbstick element.

[`GCInputRightThumbstick`](/documentation/GameController/GCInputRightThumbstick-8469p)

The name of the right thumbstick element.

[`GCInputLeftThumbstickButton`](/documentation/GameController/GCInputLeftThumbstickButton-7gej3)

The name of the left thumbstick button element.

[`GCInputRightThumbstickButton`](/documentation/GameController/GCInputRightThumbstickButton-4to77)

The name of the right thumbstick button element.

[`GCInputLeftThumbstick`](/documentation/GameController/GCInputLeftThumbstick-5tkci)

The name of the left thumbstick element.

[`GCInputRightThumbstick`](/documentation/GameController/GCInputRightThumbstick-5o085)

The name of the right thumbstick element.

[`GCInputLeftThumbstickButton`](/documentation/GameController/GCInputLeftThumbstickButton-4oxvn)

The name of the left thumbstick button element.

[`GCInputRightThumbstickButton`](/documentation/GameController/GCInputRightThumbstickButton-3k0ld)

The name of the right thumbstick button element.

### Arcade stick button names

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

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

### Additional back button names

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

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

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

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



---

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)