diff --git a/hub/images/pt-shortcut-guide-large.png b/hub/images/pt-shortcut-guide-large.png deleted file mode 100644 index a27da16b74..0000000000 Binary files a/hub/images/pt-shortcut-guide-large.png and /dev/null differ diff --git a/hub/images/pt-shortcut-guide-main-window.png b/hub/images/pt-shortcut-guide-main-window.png new file mode 100644 index 0000000000..4af1523ec5 Binary files /dev/null and b/hub/images/pt-shortcut-guide-main-window.png differ diff --git a/hub/images/pt-shortcut-guide-pin.png b/hub/images/pt-shortcut-guide-pin.png new file mode 100644 index 0000000000..68766ad858 Binary files /dev/null and b/hub/images/pt-shortcut-guide-pin.png differ diff --git a/hub/images/pt-shortcut-guide-settings.png b/hub/images/pt-shortcut-guide-settings.png index 1a73f53ecc..a9e42917df 100644 Binary files a/hub/images/pt-shortcut-guide-settings.png and b/hub/images/pt-shortcut-guide-settings.png differ diff --git a/hub/images/pt-shortcut-guide-taskbar-numbers.png b/hub/images/pt-shortcut-guide-taskbar-numbers.png new file mode 100644 index 0000000000..743a0f24e2 Binary files /dev/null and b/hub/images/pt-shortcut-guide-taskbar-numbers.png differ diff --git a/hub/images/pt-shortcut-guide-unpin.png b/hub/images/pt-shortcut-guide-unpin.png new file mode 100644 index 0000000000..2893d8b709 Binary files /dev/null and b/hub/images/pt-shortcut-guide-unpin.png differ diff --git a/hub/images/pt-shortcut-guide.png b/hub/images/pt-shortcut-guide.png index 85610c4190..0af878b776 100644 Binary files a/hub/images/pt-shortcut-guide.png and b/hub/images/pt-shortcut-guide.png differ diff --git a/hub/powertoys/index.md b/hub/powertoys/index.md index 080a4c79fb..5ce2e2cd11 100644 --- a/hub/powertoys/index.md +++ b/hub/powertoys/index.md @@ -298,14 +298,14 @@ The currently available utilities include: :::column-end::: :::row-end::: -### Shortcut Guide +### Shortcut Guide V2 :::row::: :::column::: [![A screenshot of the Shortcut Guide PowerToys utility for Windows.](../images/pt-shortcut-guide.png)](shortcut-guide.md) :::column-end::: :::column span="2"::: - [Windows key shortcut guide](shortcut-guide.md) appears when you press ⊞ Win+Shift+/ (or as we like to think, ⊞ Win+?) and shows the available shortcuts for the current state of the desktop. You can also use it by pressing and holding ⊞ Win. + [Shortcut Guide](shortcut-guide.md) appears when you press ⊞ Win+Shift+/ (or as we like to think, ⊞ Win+?) (on U.S. Keyboards) and shows the available shortcuts for the current state of the desktop. :::column-end::: :::row-end::: diff --git a/hub/powertoys/shortcut-guide.md b/hub/powertoys/shortcut-guide.md index 635b98407a..06d6e9aaff 100644 --- a/hub/powertoys/shortcut-guide.md +++ b/hub/powertoys/shortcut-guide.md @@ -1,46 +1,65 @@ --- title: PowerToys Shortcut Guide Utility for Windows -description: Learn how to use PowerToys Shortcut Guide to display Windows key shortcuts. View common keyboard shortcuts, window positioning, and taskbar shortcuts with this Windows utility. -ms.date: 08/20/2025 +description: Learn how to use PowerToys Shortcut Guide to display shortcuts of Windows an other applications. View common keyboard shortcuts, window positioning, and taskbar shortcuts with this Windows utility. +ms.date: 10/28/2025 ms.topic: concept-article no-loc: [PowerToys, Windows, File Explorer] # customer intent: As a Windows power user, I want to learn how to use the Shortcut Guide utility for Windows. --- -# Windows key shortcut guide +# Shortcut Guide V2 -The PowerToys Shortcut Guide displays common keyboard shortcuts that use the Windows key. This utility helps Windows power users quickly access keyboard shortcuts for window management, taskbar navigation, and system commands by holding the Windows key. +The PowerToys Shortcut Guide displays shortcuts for Windows and other apps. -## Get started +:::image type="content" source="../images/pt-shortcut-guide.png" alt-text="Screenshot of PowerToys Shortcut Guide showing shortcuts for window management and virtual desktops."::: + +## Currently supported applications + +Currently the following applications are supported out-of-box: +- Windows Explorer +- Windows Shell (Desktop) +- Microsoft PowerToys +- Notepad -To open the shortcut guide, hold down the ⊞ Windows key for the time as set in the PowerToys Settings (900ms by default). An overlay will appear showing keyboard shortcuts that use the Windows key, including: +> [!NOTE] +> Applications can add their own manifests containing the to be displayed shortcuts according to the [manifest specification](https://aka.ms/powertoys-sg-manifest). -- common Windows shortcuts -- shortcuts for changing the position of the active window -- taskbar shortcuts +## Get started + +Invoking the Shortcut Guide is as simple as pressing the shortcut (by default: Win + Shift + / (on U.S. Keyboards)). This brings up a window with the Shortcuts for the currently focused window. If Shortcut Guide doesn't know of any shortcuts for the currently focused window, it defaults to the shortcuts defined in Windows. -:::image type="content" source="../images/pt-shortcut-guide-large.png" alt-text="Screenshot of PowerToys Shortcut Guide overlay displaying Windows key keyboard shortcuts on desktop."::: +The Overview page shows some recommended shortcuts, your pinned shortcuts, and if it's the Windows overview page, then Taskbar shortcuts (described below) are also shown. -Keyboard shortcuts using the Windows key ⊞ Win can be used while the guide is displayed. The result of those shortcuts (active window moved, arrow shortcut behavior changes etc.) will be displayed in the guide. +:::image type="content" source="../images/pt-shortcut-guide-main-window.png" alt-text="Screenshot of PowerToys Shortcut Guide showing the overview page with pinned shortcuts."::: -Pressing the shortcut key combination again will dismiss the overlay. +On the left-hand side you can choose between all the currently supported applications that are running and view their shortcuts. On the top you can choose between different categories of shortcuts (like Window Management, Virtual Desktops, etc.) of the currently selected application. -Tapping the Windows key will display the Windows Start menu. +To close Shortcut Guide either press the close button in the top right corner, press the Escape key, or click outside of the Shortcut Guide window. > [!IMPORTANT] > The PowerToys app must be running and Shortcut Guide must be enabled in the PowerToys settings for this feature to be used. +### Taskbar shortcuts + +If the overview page of Windows is shown, the Taskbar shortcuts are also displayed at the bottom of the window. These shortcuts allow quick access to the pinned applications on the Taskbar by pressing a shortcut (for instance Win + [Number]), where [Number] corresponds to the position of the application on the Taskbar (from left to right, starting with 1). These numbers are displayed on top of the application icons. + +:::image type="content" source="../images/pt-shortcut-guide-taskbar-numbers.png" alt-text="Screenshot of PowerToys Shortcut Guide showing taskbar shortcuts at the bottom of the window."::: + +### Pinning/Unpinning shortcuts + +You can right-click on any shortcut and select "Pin" to pin it to the overview page of the currently selected application or "Unpin" to remove it from the overview page. + +:::image type="content" source="../images/pt-shortcut-guide-pin.png" alt-text="Screenshot of PowerToys Shortcut Guide showing the context menu to pin a shortcut."::: +:::image type="content" source="../images/pt-shortcut-guide-unpin.png" alt-text="Screenshot of PowerToys Shortcut Guide showing the context menu to unpin a shortcut."::: + ## Settings These configurations can be edited from the PowerToys Settings: | Setting | Description | | :--- | :--- | -| Activation method | Choose your own shortcut or use the ⊞ Win key | -| Press duration | The duration (in milliseconds) to hold down the ⊞ Win key in order to open the shortcut guide | | Activation shortcut | The custom shortcut used to open the shortcut guide | | App theme | **Light**, **Dark** or **Windows default** | -| Background opacity | Opacity of the Shortcut Guide overlay | | Excluded apps | Ignores Shortcut Guide when these apps are in focus. Add an application's name, or part of the name, one per line (e.g. adding `Notepad` will match both `Notepad.exe` and `Notepad++.exe`; to match only `Notepad.exe` add the `.exe` extension). | :::image type="content" source="../images/pt-shortcut-guide-settings.png" alt-text="Screenshot of PowerToys Shortcut Guide settings page showing activation method and customization options.":::