Merge pull request #5705 from MicrosoftDocs/main

Auto Publish – main to live - 2025-08-21 05:00 UTC

Author: learn-build-service-prod[bot]

hub/images/powertoys-settings-home.png

@@ -1,6 +1,6 @@
 ---
-title: PowerToys administrator mode for Windows
-description: For PowerToys to work with an app running in elevated admin mode, PowerToys must be running in administrator mode as well.
+title: Run PowerToys in Administrator Mode on Windows
+description: Learn how to run PowerToys in administrator mode to ensure compatibility with elevated apps on Windows. Fix FancyZones and other utilities when they don't work with admin applications.
 ms.date: 11/19/2024
 ms.topic: concept-article
 ms.localizationpriority: medium
@@ -10,7 +10,7 @@ no-loc: [PowerToys, Windows, FancyZones, Fancy, Zone, Zones]
 
 # PowerToys running with administrator permissions
 
-When running any application as an administrator (also referred to as elevated permissions), PowerToys may not work correctly when the elevated applications are in focus or trying to interact with a PowerToys feature like FancyZones. This can be addressed by also running PowerToys as administrator.
+PowerToys administrator mode is required when you need PowerToys utilities to work with elevated applications on Windows. When running any application as an administrator (also referred to as elevated permissions), PowerToys may not work correctly when the elevated applications are in focus or trying to interact with a PowerToys feature like FancyZones. This can be addressed by also running PowerToys as administrator.
 
 ## Options
 
@@ -68,8 +68,10 @@ The simplest way to run an app or program in administrative mode is to right-cli
 
 If you see this User Account Control prompt, the application is requesting administrator level elevated permission:
 
-![Windows UAC elevated permission prompt screenshot](../images/pt-admin-prompt.png)
+:::image type="content" source="../images/pt-admin-prompt.png" alt-text="Screenshot of Windows User Account Control prompt requesting administrator permissions for PowerToys.":::
 
 In the case of an elevated command line, typically the text "Administrator" will be included in the title bar.
 
-![Windows Powershell and Command Line with elevated permissions screenshot](../images/pt-admin-terminal.png)
+:::image type="content" source="../images/pt-admin-terminal.png" alt-text="Screenshot of Windows PowerShell and Command Prompt running with administrator permissions showing elevated status in title bar.":::
+
+[!INCLUDE [install-powertoys.md](../includes/install-powertoys.md)]

hub/powertoys/administrator.md

@@ -1,23 +1,25 @@
 ---
-title: PowerToys Advanced Paste for Windows
-description: A tool that enables you to paste the text from your clipboard into any format needed. It can be enhanced with an AI-powered option that is 100% opt-in and requires an OpenAI key.
-ms.date: 02/28/2025
+title: Advanced Paste Tool for Clipboard Management in PowerToys
+description: Learn how to use PowerToys Advanced Paste to transform clipboard content into any format - plain text, JSON, Markdown, or files. Includes opt-in AI-powered features and local OCR capabilities.
+ms.date: 08/20/2025
 ms.topic: concept-article
 no-loc: [PowerToys, Windows, Paste as Plain Text, Advanced Paste, Win]
 # Customer intent: Learn how to use the Advanced Paste feature in PowerToys to paste text from your clipboard into any format needed.
 ---
 
-# Advanced Paste
+# Advanced Paste tool for clipboard management
 
-PowerToys **Advanced Paste** is a tool that enables you to paste the content from your clipboard into any format needed. It can paste as plain text, markdown, JSON, .txt file, .html file, or .png file directly with the UX or with a direct keystroke invoke. It can also extract and paste the text directly from an image in your clipboard or transcode audio or video from your clipboard to an .mp3 or .mp4 file. These actions are executed entirely on your local machine. Additionally, the tool has an AI-powered option that is 100% opt-in and requires entering an OpenAI key in settings.
+PowerToys **Advanced Paste** is a powerful clipboard management tool that transforms your clipboard content into any format you need. This tool enables you to paste content as plain text, markdown, JSON, or various file formats (.txt, .html, .png) using either the interface or keyboard shortcuts. Advanced Paste can extract text from images using local OCR technology and transcode audio/video files to .mp3 or .mp4 formats. All processing happens locally on your machine, with an optional AI-powered feature that requires an OpenAI API key.
 
-## Getting started
+## Get started with Advanced Paste
 
-### Enabling
+Get familiar with the features and capabilities of Advanced Paste.
+
+### Enable Advanced Paste
 
 To start using Advanced Paste, enable it in the PowerToys Settings.
 
-### Activating
+### Activate the Advanced Paste window
 
 Open the **Advanced Paste** window with the activation shortcut (default: <kbd>Win</kbd>+<kbd>Shift</kbd>+<kbd>V</kbd>). See the [Settings](#settings) section for more information on customizing the activation shortcut and additional shortcut actions.
 
@@ -29,11 +31,11 @@ From the Settings menu, the following options can be configured:
 | :--- | :--- |
 | Enable Paste with AI | Enables the AI-powered paste feature. An OpenAI API key is required (requires an account on [platform.openai.com](https://platform.openai.com/docs/overview)). See [Paste text with AI](#paste-text-with-ai) for more information. |
 | Enable advanced AI | Enables the Advanced AI feature which allows [Semantic Kernel](/semantic-kernel/overview/) to be used to define a chain of actions to be performed when using "Paste with AI". See [Paste with Advanced AI](#paste-with-advanced-ai) for more information.<br/><br/>This setting is off and disabled when Enable Paste with AI is disabled. When enabling Enable Paste with AI, Enable advanced AI is also enabled by default, allowing users immediate access to the feature. |
-| Custom format preview | Enable to preview the output of the custom format before pasting. |
 | Clipboard history | Enable to automatically save clipboard history. |
-| Open Advanced Paste shortcut | The customizable keyboard command to open the **Advanced Paste** window. |
 | Automatically close the Advanced Paste window after it loses focus | Determines whether the Advanced Paste window will close after focus is lost from the window. |
-| Custom Actions | When using Paste with AI, save the prompts you frequently use and give them descriptive names, so you can easily select them from the Advanced Paste window without having to type them out. You can also assign each action a keyboard command, so you can execute them without opening the Advanced Paste window. |
+| Custom format preview | Enable to preview the output of the custom format before pasting. |
+| Actions (Create and manage Advanced Paste custom actions) | When using Paste with AI, save the prompts you frequently use and give them descriptive names, so you can easily select them from the Advanced Paste window without having to type them out. You can also assign each action a keyboard command, so you can execute them without opening the Advanced Paste window. |
+| Open Advanced Paste window shortcut | The customizable keyboard command to open the **Advanced Paste** window. |
 | Paste as plain text directly shortcut | The customizable keyboard command to paste as plain text without opening the **Advanced Paste** window. |
 | Paste as Markdown directly shortcut | The customizable keyboard command to paste as Markdown without opening the **Advanced Paste** window. |
 | Paste as JSON directly shortcut | The customizable keyboard command to paste as JSON without opening the **Advanced Paste** window. |

hub/powertoys/advanced-paste.md

@@ -1,17 +1,17 @@
 ---
-title: PowerToys Always On Top utility for Windows
-description: A system-wide utility for Windows that allows you to pin windows to the top of your screen.
-ms.date: 11/19/2024
+title: PowerToys Always On Top Utility for Windows
+description: Learn how to use PowerToys Always On Top utility to pin windows above others in Windows. Keep important windows visible with customizable shortcuts and settings.
+ms.date: 08/20/2025
 ms.topic: concept-article
 no-loc: [PowerToys, Windows, Always On Top, Win]
 # Customer intent: As a Windows power user, I want to learn about the Always On Top utility in PowerToys.
 ---
 
 # Always On Top utility
 
-A system-wide Windows utility to pin windows above other windows.
+PowerToys Always On Top is a system-wide Windows utility that allows you to pin windows above other windows. This utility helps you keep important windows visible at all times, improving your productivity by ensuring critical information stays accessible while you work with other applications.
 
-![Always On Top screenshot](../images/pt-always-on-top.png)
+:::image type="content" source="../images/pt-always-on-top.png" alt-text="Screenshot of PowerToys Always On Top utility showing a pinned window with colored border highlighting.":::
 
 ## Pin a window
 
@@ -34,7 +34,7 @@ Always On Top has the following settings:
 | **Color** | The custom color of the highlight border. **Color** is only available when **Color mode** is set to **Custom color**. |
 | **Opacity (%)** | The opacity of the highlight border. |
 | **Thickness (px)** | The thickness of the highlight border in pixels. |
-| **Enable round corners** | When selected, the highlight border around the pinned window will have rounded corners.  |
+| **Enable rounded corners** | When selected, the highlight border around the pinned window will have rounded corners.  |
 | **Play a sound when pinning a window** | When selected, this option plays a sound when you activate or deactivate Always On Top. |
 | **Excluded apps** | Prevents you from pinning an application using Always On Top. Add an application's name to stop it from being pinned. The list will also exclude partial matches. For example, `Notepad` will prevent both Notepad.exe and Notepad++.exe from being pinned. To only prevent a specific application, add `Notepad.exe` to the excluded list. |
 

hub/powertoys/always-on-top.md

@@ -1,15 +1,15 @@
 ---
-title: PowerToys Awake utility for Windows
-description: A tool for a Windows computer to stay awake.
-ms.date: 11/19/2024
+title: PowerToys Awake - Keep Windows Computer Awake Tool
+description: Learn how to use PowerToys Awake to keep your Windows computer awake without changing power settings. Configure timed, indefinite, or scheduled awake modes with CLI support.
+ms.date: 08/20/2025
 ms.topic: concept-article
 ms.localizationpriority: medium
 # Customer intent: As a Windows power user, I want to learn how to configure and use the PowerToys Awake utility.
 ---
 
 # PowerToys Awake utility
 
-PowerToys Awake is a tool for Windows designed to keep a computer awake without having to manage its [power and sleep settings](https://support.microsoft.com/windows/how-to-adjust-power-and-sleep-settings-26f623b5-4fcc-4194-863d-b824e5ea7679). This can be helpful when running time-consuming tasks, ensuring that the computer does not go to sleep or turn off its screens.
+PowerToys Awake is a Windows utility that keeps your computer awake without modifying [power and sleep settings](https://support.microsoft.com/windows/how-to-adjust-power-and-sleep-settings-26f623b5-4fcc-4194-863d-b824e5ea7679). This tool helps prevent your computer from sleeping during long-running tasks, presentations, or downloads, ensuring your work continues uninterrupted.
 
 ## Getting started
 
@@ -22,7 +22,7 @@ You can use PowerToys Awake directly from PowerToys Settings or as a standalone
 
 In the PowerToys Settings, start PowerToys Awake by toggling **Enable Awake** on. Once enabled, the application will manage the power and screen state of the computer.
 
-![A screenshot of the Awake settings](../images/powertoys-awake/pt-awake-settings-menu.png)
+:::image type="content" source="../images/powertoys-awake/pt-awake-settings-menu.png" alt-text="Screenshot of PowerToys Awake settings menu showing enable toggle and power mode options.":::
 
 PowerToys Awake supports a variety of modes that can be used to control computer and screen power behaviors:
 

hub/powertoys/awake.md

@@ -1,20 +1,20 @@
 ---
-title: PowerToys Command Not Found for Windows
-description: A PowerShell 7 module that detects an error thrown by a command and suggests a relevant WinGet package to install, if available.
-ms.date: 11/19/2024
+title: PowerToys Command Not Found Tool for PowerShell 7 on Windows
+description: Learn how to use PowerToys Command Not Found tool for PowerShell 7. Automatically detect command errors and get WinGet package suggestions to install missing tools.
+ms.date: 08/20/2025
 ms.topic: concept-article
 no-loc: [PowerToys, Windows, Command Not Found, Win]
 # Customer intent: As a Windows power user, I want to learn about the Command Not Found utility in PowerToys for Windows.
 ---
 
-# Command Not Found utility
+# Command Not Found utility for PowerShell
 
-A PowerShell 7 module that detects command-line errors and suggests a relevant WinGet package to install, if available.
+The PowerToys Command Not Found utility is a PowerShell 7 module that detects command-line errors and suggests relevant WinGet packages to install. This tool helps Windows users quickly find and install missing commands, improving productivity and reducing troubleshooting time.
 
 > [!IMPORTANT]
 > There are some incompatibilities between Command Not Found and some PowerShell configurations. Read more about them in [issue 30818](https://github.com/microsoft/PowerToys/issues/30818) on GitHub.
 
-![Command Not Found screenshot](../images/pt-cmd-not-found.png)
+:::image type="content" source="../images/pt-cmd-not-found.png" alt-text="Screenshot of PowerToys Command Not Found utility suggesting WinGet package installation in PowerShell terminal.":::
 
 ## Requirements
 

hub/powertoys/cmd-not-found.md

@@ -1,7 +1,7 @@
 ---
-title: PowerToys Color Picker Utility for Windows
-description: A system-wide color picking utility for Windows to pick colors from any screen and copy it to the clipboard in a configurable format.
-ms.date: 07/01/2025
+title: Color Picker Utility in PowerToys for Windows
+description: Use Color Picker in PowerToys to pick colors from any Windows screen and copy them to clipboard in multiple formats. Start designing faster today.
+ms.date: 08/20/2025
 ms.topic: concept-article
 ms.localizationpriority: medium
 no-loc: [PowerToys, Windows, Color Picker, Color, Picker]
@@ -10,28 +10,28 @@ no-loc: [PowerToys, Windows, Color Picker, Color, Picker]
 
 # Color Picker utility
 
-Color Picker is a PowerToys utility for Windows that lets you pick colors from any screen and copy it to the clipboard in a configurable format.
+Color Picker is a PowerToys utility for Windows that lets you pick colors from any screen and copy them to the clipboard in configurable formats. This tool helps designers and developers quickly capture exact colors for their projects.
 
-![Color Picker screenshot](../images/pt-colorpicker-hex-editor.png)
+![A screenshot of the Color Picker utility.](../images/pt-colorpicker-hex-editor.png)
 
-## Getting started
+## Get started with Color Picker
 
 Getting started with Color Picker is easy. You can activate it using a keyboard shortcut, select a color from your screen, and copy it to the clipboard in the format of your choice.
 
-### Enabling Color Picker
+### Enable Color Picker
 
 You can enable the Color Picker in PowerToys Settings.
 
-### Activating Color Picker
+### Activate Color Picker
 
 Choose what happens when you activate Color Picker (default: <kbd>Win</kbd>+<kbd>Shift</kbd>+<kbd>C</kbd>) by changing **Activation Behavior**:
 
-:::image type="content" source="../images/pt-colorpicker-activation.gif" alt-text="Color Picker behaviors.":::
+:::image type="content" source="../images/pt-colorpicker-activation.gif" alt-text="Screenshot of Color Picker activation behaviors showing different options for when the utility is activated.":::
 
 - **Open editor** opens an editor that lets you choose a color from the colors history, fine-tune a selected color, or pick a new color.
-- **Pick a color first** activates Color Picker. You can then take action on the selected color using the options described in the **Picking colors** section below.
+- **Pick a color first** activates Color Picker. You can then take action on the selected color using the options described in the **Pick colors from your screen** section below.
 
-### Picking colors
+### Pick colors from your screen
 
 After activating Color Picker, select a color on your screen to pick that color. If you want to see the area under your cursor in more detail, scroll up to zoom in. You can assign different actions to each of the mouse buttons in Color Picker's settings. The default actions for each button are:
 
@@ -52,7 +52,7 @@ Color Picker copies the selected color to the clipboard in the **Default color f
 > 2. Zoom in by scrolling the mouse wheel up. Image will be frozen.
 > 3. In the enlarged area, you can pick the color of the element.
 
-## Using the Color Picker editor
+## Use the Color Picker editor
 
 The Color Picker editor stores a history of up to 20 picked colors and lets you copy them to the clipboard. You can choose which color formats are visible in the editor in **Color formats** in PowerToys Settings.
 
@@ -78,15 +78,15 @@ Color Picker has the following settings:
 | Setting | Description |
 | :--- | :--- |
 | **Activation shortcut** | The shortcut that activates Color Picker. |
-| **Activation behavior** | Select what happens when you activate Color Picker. Read more about this setting in [Activating Color Picker](#activating-color-picker). |
+| **Activation behavior** | Select what happens when you activate Color Picker. Read more about this setting in [Activate Color Picker](#activate-color-picker). |
 | **Mouse actions** | Select what happens when you click each of the mouse buttons while Color Picker is active. The default actions for each button are:<br/><br/>**Left click**: Pick a color and open editor<br/>**Scroll wheel click**: Pick a color and close<br/>**Right click**: Close |
 | **Default color format** | The color format that Color Picker uses when copying colors to the clipboard. |
 | **Show color name** | Displays a high-level representation of the color. For example, 'Light Green', 'Green', or 'Dark Green'. |
-| **Color formats** | Enable and add different color formats, and change the order of color formats in the Color Picker editor. Read more about color formats in [Managing color formats](#managing-color-formats). |
+| **Color formats** | Enable and add different color formats, and change the order of color formats in the Color Picker editor. Read more about color formats in [Manage color formats](#manage-color-formats). |
 
 ![Color Picker Settings screenshot](../images/pt-colorpicker-settings.png)
 
-### Managing color formats
+### Manage color formats
 
 You can add, edit, delete, disable, and change the order of color formats in **Color formats**.