Why doesn't my Button's shortcut fire when I press its key?

The Button's shortcut requires either focus is on the Button (or in its shortcut_context subtree) or the Button is in a focused window. Set shortcut_context to the parent Control that owns focus.

What is shortcut_context for?

Restricts shortcut activation to only when focus is somewhere inside the named context. Avoids accidentally triggering shortcuts from menus that aren't visible.

Should shortcuts use raw keys or actions?

Actions. Define a shortcut Resource that contains an InputEventAction. Then rebinding the action automatically rebinds the shortcut.

Fix: Godot 4 ShortcutContext Not Receiving Action

Quick answer: Set button.shortcut_context to a parent Control that holds focus. The shortcut fires when focus is anywhere in that subtree. Use a Shortcut resource with an InputEventAction.

A Save button has Ctrl-S as a shortcut. Press it; nothing happens. Focus is on a text field elsewhere; the shortcut path doesn’t reach the button.

The Symptom

BaseButton.shortcut set, key combo doesn’t trigger pressed signal. Clicking the button works.

The Fix

SaveButton:
  shortcut:          ShortcutResource (Ctrl+S)
  shortcut_context:  $MenuBar    # or parent that owns focus

Make a Shortcut resource:

ShortcutResource (.tres):
  events: [InputEventKey { ctrl_pressed = true, keycode = KEY_S }]

Or better, an InputEventAction reference so rebinds propagate.

Focus Behavior

When focus is in any descendant of shortcut_context, the shortcut fires. If shortcut_context is empty, only direct focus on the button itself triggers.

Verifying

Click into a text field within the menu bar. Press Ctrl-S. Save action should fire. Click outside the menu bar; press Ctrl-S; nothing fires.

“Context defines scope. Resource defines combo. Shortcut works.”

Related Issues

For Control mouse_filter, see mouse filter. For input deadzone, see deadzone.

Context plus shortcut. Right scope.