Merge pull request #6583 from MicrosoftDocs/main

Auto Publish – main to live - 2026-04-02 05:00 UTC

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

hub/apps/develop/toc.yml

@@ -132,7 +132,7 @@ You've built a complete WinUI 3 notes app using:
 
 ## Optional: Add on-device AI to your app
 
-The notes app is fully functional — but you can take it further by adding an AI feature that runs entirely on the user's device. [Foundry Local](https://learn.microsoft.com/windows/ai/foundry-local/get-started) makes this straightforward: it runs a language model locally and exposes an OpenAI-compatible API.
+The notes app is fully functional — but you can take it further by adding an AI feature that runs entirely on the user's device. [Foundry Local](/windows/ai/foundry-local/get-started) makes this straightforward: it runs a language model locally and exposes an OpenAI-compatible API.
 
 ### Install Foundry Local and download a model
 
@@ -171,7 +171,7 @@ var completion = await client.GetChatClient("phi-4-mini")
 No internet connection required. No API key. The model runs on their PC — fast, private, and free.
 
 > [!TIP]
-> For apps targeting Copilot+ PCs, you can swap Foundry Local for [Phi Silica](https://learn.microsoft.com/windows/ai/apis/phi-silica) to use the NPU directly for even faster inference. The API surface is different (Windows AI APIs rather than OpenAI-compatible), but Copilot can help you make the switch.
+> For apps targeting Copilot+ PCs, you can swap Foundry Local for [Phi Silica](/windows/ai/apis/phi-silica) to use the NPU directly for even faster inference. The API surface is different (Windows AI APIs rather than OpenAI-compatible), but Copilot can help you make the switch.
 
 ---
 

hub/apps/get-started/ai-build.md

@@ -16,7 +16,7 @@ Windows is where AI development is happening — both for developers writing app
 This article covers both: the AI coding tools that help you build Windows apps faster, and the Windows AI stack that lets you put intelligence directly into your app. When you're ready, follow the links to set up your environment and start building.
 
 > [!TIP]
-> **New to Windows development?** Windows has the deepest local AI stack of any platform: [Foundry Local](https://learn.microsoft.com/windows/ai/foundry-local/get-started) runs state-of-the-art models on any hardware, [Phi Silica](https://learn.microsoft.com/windows/ai/apis/phi-silica) uses the NPU on Copilot+ PCs for near-instant inference, and the full [Windows AI API surface](/windows/ai/) is available to any packaged app. If you're coming from Linux or macOS, Windows Subsystem for Linux (WSL) and the GitHub Copilot CLI Terminal mean you don't have to give up your existing workflow to get started.
+> **New to Windows development?** Windows has the deepest local AI stack of any platform: [Foundry Local](/windows/ai/foundry-local/get-started) runs state-of-the-art models on any hardware, [Phi Silica](/windows/ai/apis/phi-silica) uses the NPU on Copilot+ PCs for near-instant inference, and the full [Windows AI API surface](/windows/ai/) is available to any packaged app. If you're coming from Linux or macOS, Windows Subsystem for Linux (WSL) and the GitHub Copilot CLI Terminal mean you don't have to give up your existing workflow to get started.
 
 ## Two ways AI changes Windows development
 
@@ -95,7 +95,7 @@ The Windows AI stack lets you ship AI features directly in your app — with har
 
 ### Foundry Local
 
-[Foundry Local](https://learn.microsoft.com/windows/ai/foundry-local/get-started) runs large language models locally on any Windows PC. It exposes an OpenAI-compatible REST API, so you can use your existing AI code against local models with no rewrite. Foundry Local is the recommended starting point for adding AI to a Windows app — it works on any hardware, requires no Azure subscription, and keeps user data on-device.
+[Foundry Local](/windows/ai/foundry-local/get-started) runs large language models locally on any Windows PC. It exposes an OpenAI-compatible REST API, so you can use your existing AI code against local models with no rewrite. Foundry Local is the recommended starting point for adding AI to a Windows app — it works on any hardware, requires no Azure subscription, and keeps user data on-device.
 
 ```bash
 winget install Microsoft.AIFoundry.Local
@@ -106,7 +106,7 @@ After the model starts, call it from your app using the OpenAI-compatible endpoi
 
 ### Phi Silica
 
-[Phi Silica](https://learn.microsoft.com/windows/ai/apis/phi-silica) is a compact, highly capable model built into Windows 11 on Copilot+ PCs. It runs entirely on the NPU — no GPU, no cloud, near-instant inference. If your app targets Copilot+ PCs, Phi Silica is the fastest local AI option available.
+[Phi Silica](/windows/ai/apis/phi-silica) is a compact, highly capable model built into Windows 11 on Copilot+ PCs. It runs entirely on the NPU — no GPU, no cloud, near-instant inference. If your app targets Copilot+ PCs, Phi Silica is the fastest local AI option available.
 
 > [!NOTE]
 > Phi Silica requires a Copilot+ PC (with NPU, 40+ TOPS). For apps targeting all Windows hardware, use Foundry Local with a fallback to cloud APIs.
@@ -132,7 +132,7 @@ All of these run on-device, require no cloud subscription, and become available
 Or jump straight to:
 
 - [Tutorial: Build a Windows app with GitHub Copilot](ai-build.md)
-- [Get started with Foundry Local](https://learn.microsoft.com/windows/ai/foundry-local/get-started)
+- [Get started with Foundry Local](/windows/ai/foundry-local/get-started)
 - [Modernize or port a Windows app with Copilot](../windows-app-sdk/migrate-to-windows-app-sdk/ai-modernize.md)
 - [Agentic AI tools for Windows development](../dev-tools/agentic-tools.md)
 - [Windows AI APIs overview](/windows/ai/)

hub/apps/get-started/ai-for-windows-developers.md

@@ -9,7 +9,7 @@ ms.localizationpriority: medium
 
 # What’s New - Recent data view in Usage reports
 
-The [**Recent data** view in Usage reports](https://partner.microsoft.com/dashboard/insights/analytics/store/usage?viewSelected=48h) provides near real‑time visibility into how users are engaging with your app. With this launch, data is now refreshed in about 3 hours instead of 30 hours, delivering a faster and more responsive reporting experience. This view is designed to complement the [existing daily and longer‑term Usage insights](https://learn.microsoft.com/windows/apps/publish/usage) by focusing on very recent activity, helping you react quickly to changes without waiting for daily aggregation. 
+The [**Recent data** view in Usage reports](https://partner.microsoft.com/dashboard/insights/analytics/store/usage?viewSelected=48h) provides near real‑time visibility into how users are engaging with your app. With this launch, data is now refreshed in about 3 hours instead of 30 hours, delivering a faster and more responsive reporting experience. This view is designed to complement the [existing daily and longer‑term Usage insights](/windows/apps/publish/usage) by focusing on very recent activity, helping you react quickly to changes without waiting for daily aggregation. 
 
 #### What the Recent data view shows
 

hub/apps/publish/recent-data-usage-reports.md

@@ -11,7 +11,7 @@ ms.localizationpriority: medium
 The new onboarding process allows company developers to publish apps to the Microsoft Store without any onboarding fees.  
 
 > [!NOTE]
-> This onboarding experience is currently available in India. Availability will expand to additional markets over time.
+> This onboarding experience is currently available in flighted markets (including US) only. Availability will expand to additional markets over time.
 
 ## What’s New
 

hub/apps/publish/whats-new-company-developer.md

@@ -74,7 +74,7 @@ For most Java development — web backends, Android, enterprise apps — native
 > [!div class="nextstepaction"]
 > [Java on Azure and Windows documentation](/java/)
 
-- [Java for Beginners (video series)](https://learn.microsoft.com/shows/java-for-beginners/)
+- [Java for Beginners (video series)](/shows/java-for-beginners/)
 - [Learn Java (java.com)](https://dev.java/learn/)
 - [Maven in 5 minutes](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html)
 - [Gradle quickstart](https://docs.gradle.org/current/userguide/getting_started_eng.html)

hub/dev-environment/java.md

@@ -33,7 +33,9 @@ From the Settings menu, configure the following options:
 | Model providers | Lists the configured AI model providers for use with Paste with AI. You can add providers with the **Add model** button. See [Adding a model provider](#adding-a-model-provider) for a list of supported providers and more information about configuring them. An account and valid API key is required for online model providers. You can also remove any of the configured providers from this list. |
 | Clipboard history | Enable to automatically save clipboard history. |
 | Automatically close the Advanced Paste window after it loses focus | Determines whether the Advanced Paste window closes after it loses focus. |
+| Show clipboard preview | Display a preview of the current clipboard content in the Advanced Paste window. |
 | Custom format preview | Enable to preview the output of the custom format before pasting. |
+| Auto-copy selection for custom action hotkeys | When enabled, attempts to copy the current selection before running a custom action shortcut, so you can trigger custom actions directly on selected text without manually copying first. |
 | 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. |

hub/powertoys/advanced-paste.md

@@ -35,14 +35,18 @@ Select the **Close** button of the cropped window to close it and restore the or
 
 ### Thumbnail
 
-Creates a window that shows the selected area of the original window. Any changes to the original window's selected area will be reflected on the thumbnail, but the original application can't be controlled through the thumbnail. This mode has the best compatibility.
+Creates a window that shows the selected area of the original window. Any changes to the original window's selected area will be reflected on the thumbnail, but the original application can't be controlled through the thumbnail. This mode has the best compatibility across apps.
 
 ### Reparent
 
 Creates a window that replaces the original window, showing only the selected area. The application will now be controlled through the cropped window. Closing the cropped window will restore the original window.
 
 Not every window will react well to being contained in another application so this mode has many compatibility issues. It's advisable to use the "Thumbnail" mode instead if you find that a window isn't responding well to being cropped with the "Reparent" mode.
 
+### Screenshot
+
+Creates a window that shows the selected area of the original window as a frozen snapshot. This mode has good compatibility across apps as well.
+
 ## Known issues
 
 Crop And Lock currently has the following known issues:
@@ -59,5 +63,6 @@ The following settings are available for the Crop And Lock utility:
 | :--- | :--- |
 | **Thumbnail shortcut** | The customizable keyboard command to activate the thumbnail mode for cropping and creating a thumbnail view. |
 | **Reparent shortcut** | The customizable keyboard command to activate the reparent mode for cropping and reparenting to a new window. |
+| **Screenshot shortcut** | The customizable keyboard command to create a cropped, static screenshot of another window. Unlike the thumbnail mode, the screenshot does not update with the original window's content. |
 
 [!INCLUDE [install-powertoys.md](../includes/install-powertoys.md)]

hub/powertoys/crop-and-lock.md

@@ -17,7 +17,7 @@ PowerToys File Explorer add-ons enhance Windows File Explorer with preview pane
 
 ## Preview Pane previewers
 
-Preview Pane is an existing feature in Windows File Explorer which allows you to see a preview of the file's contents in the view's reading pane. PowerToys adds multiple extensions: Markdown, SVG, PDF, G-code and QOI. In addition to those, PowerToys also adds support for source code files for more than 150 file extensions.
+Preview Pane is an existing feature in Windows File Explorer which allows you to see a preview of the file's contents in the view's reading pane. PowerToys adds multiple extensions: Markdown, SVG, PDF, G-code, Binary G-code (BGCODE), and QOI. In addition to those, PowerToys also adds support for source code files for more than 150 file extensions.
 
 Preview Pane supports:
 
@@ -26,8 +26,17 @@ Preview Pane supports:
 - Source code files (.cs, .cpp, .rs, …)
 - PDF files (.pdf)
 - G-code files (.gcode)
+- Binary G-code files (.bgcode)
 - QOI images (.qoi)
 
+### Settings for SVG images previewer
+
+Expand the **Scalable Vector Graphics** section to change the following settings.
+
+| Setting | Description |
+| :-- | :-- |
+| Checkered shade | Set the background shade for SVG previews. This helps visualize transparent areas in SVG images. |
+
 ### Settings for Source code files previewer
 
 Expand the **Source code files (Monaco)** section to change the following settings.
@@ -37,6 +46,9 @@ Expand the **Source code files (Monaco)** section to change the following settin
 | Wrap text | Enable or disable word wrapping. |
 | Try to format the source for preview | Enable or disable formatting of the source code for json and xml files.<br />The original file stays unchanged. |
 | Maximum file size to preview | Maximum file size in kilobytes to preview. |
+| Font size | Font size of the editor in points. Recommended: 14pt. |
+| Enable sticky scroll | When enabled, keeps the current scope (such as function or class headers) pinned at the top of the preview while scrolling. |
+| Show minimap | When enabled, displays a minimap overview of the code in the preview window. |
 
 ### Enabling Preview Pane support
 
@@ -70,6 +82,7 @@ Thumbnail preview supports:
 - SVG images (.svg)
 - PDF files (.pdf)
 - G-code files (.gcode)
+- Binary G-code files (.bgcode)
 - STL files (.stl)
 - QOI images (.qoi)
 

hub/powertoys/file-explorer.md

@@ -15,7 +15,13 @@ The General settings section of Microsoft PowerToys allows you to configure esse
 
 ## Version & updates
 
-Here you can check for new updates, and if one is available, you can download and install it. You can also indicate whether updates should be downloaded automatically, if you want to be notified about new releases, and if the release notes should be displayed after an update.
+Here you can check for new updates, and if one is available, you can download and install it.
+
+| Setting | Description |
+| :--- | :--- |
+| Download updates automatically | When enabled, PowerToys automatically downloads available updates in the background. |
+| Show new updates as toast notifications | When enabled, displays a Windows toast notification when a new update is available. |
+| Show what's new after updates | When enabled, displays a "What's New" dialog after updates are applied so you can see the latest changes. |
 
 ## Settings search
 
@@ -35,7 +41,11 @@ PowerToys includes a feature to detect shortcut conflicts. If you have multiple
 
 ## Administrator mode
 
-Read more about the administrator mode in the [PowerToys running with administrator permissions](./administrator.md) section of the documentation.
+PowerToys can run in administrator mode for enhanced capabilities. Read more about the administrator mode in the [PowerToys running with administrator permissions](./administrator.md) section of the documentation.
+
+| Setting | Description |
+| :--- | :--- |
+| Warnings for elevated apps | When enabled, shows warnings when an elevated (administrator) application may interfere with PowerToys utilities. This helps you understand when certain features might not work as expected due to Windows security boundaries between elevated and non-elevated processes. |
 
 ## Appearance & behavior
 
@@ -55,7 +65,18 @@ If activated, PowerToys will start automatically when you log in to Windows.
 
 When activated, PowerToys shows an icon in the system tray area of the taskbar. You can use this icon to open the PowerToys settings app or the PowerToys flyout.
 
-In addition, you can control whether the Quick Access flyout is enabled, assign a hotkey, and choose a theme-aware monochrome system tray icon.
+| Setting | Description |
+| :--- | :--- |
+| Show theme-adaptive system tray icon | When enabled, the system tray icon uses a monochrome icon that adapts to your current Windows theme (light or dark) for a more consistent appearance. |
+
+### Quick Access flyout
+
+The Quick Access flyout provides a shortcut to toggle PowerToys utilities on or off without opening the full Settings window.
+
+| Setting | Description |
+| :--- | :--- |
+| Enable Quick Access | Enable or disable the Quick Access flyout. |
+| Quick Access shortcut | Set the keyboard shortcut to open the Quick Access flyout. |
 
 ## Back up & restore