Merge pull request #5406 from MicrosoftDocs/main

Merging main into live

Author: drewbatgit

hub/apps/develop/search/cloud-search-integration.md

@@ -0,0 +1,11 @@
+---
+description: Learn about cloud files provider integration with Windows Search.
+title: Cloud files provider integration with Windows Search
+ms.topic: article
+ms.date: 05/08/2025
+ms.localizationpriority: medium
+---
+
+# Cloud files provider integration with Windows Search
+
+Windows Search integrates with Cloud Sync Engines. When searching for files, Windows Search will call into all registered cloud files providers. Cloud files providers must implement [IStorageProviderSearchHandlerFactory](/uwp/api/windows.storage.provider.istorageprovidersearchhandlerfactory) in order to be integrated into the Windows Search experience. For more information about implementing a Cloud Sync Engine, see [Cloud Sync Engines](/windows/win32/cfapi/cloud-files-api-portal). 

hub/apps/develop/search/images/search-integration.png

@@ -0,0 +1,20 @@
+---
+description: This section of the documentation provides developer guidance for integrating with Windows Search.
+title: Integrate with Windows Search
+ms.topic: article
+ms.date: 05/08/2025
+ms.localizationpriority: medium
+---
+
+# Integrate with Windows Search
+
+This section of the documentation provides developer guidance for integrating with Windows Search.
+
+## Windows system components that support 3rd party integration
+
+The following table lists the Windows Search integration features for 3rd party developers.
+
+| Feature | Description |
+|--|--|
+| [Web search providers](search-providers.md) | Learn how to integrate a web search provider with Windows. Only available the European Economic Area (EEA). |
+| [Cloud files provider integration with Windows Search](cloud-search-integration.md) | Learn about cloud file provider integration with Windows Search. |

hub/apps/develop/search/index.md

@@ -1,5 +1,5 @@
 ---
-title: Windows Search providers
+title: Windows Search web search providers
 description: Learn how to integrate into the Windows Search experience. 
 ms.topic: article
 ms.date: 09/07/2023
@@ -8,18 +8,13 @@ ms.localizationpriority: medium
 
 
 
-# Windows Search providers
+# Windows Search web search providers
 
-> [!NOTE]
-> **Some information relates to pre-released product, which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.**
-> [!IMPORTANT]
-> The feature described in this topic is available in preview builds of Windows starting with build 22631.2787 for Windows 11 and build 19045.3758 for Windows 10, although newer builds are recommended because they contain stability improvements. For information on preview builds of Windows, see [Windows 10 Insider Preview](https://insider.windows.com/en-us/preview-windows).
-
-Windows Search currently uses the Web Search from Microsoft Bing app to return web content and search results. In the European Economic Area (EEA), you can enable installed apps that implement a web search provider to return web content and search results in Windows Search through Settings.
+Windows Search currently uses the Web Search from Microsoft Bing app to return web content and search results. In the European Economic Area (EEA), you can install apps that implement a web search provider to return web content and search results in Windows Search.
 
 :::image type="content" source="images/search-integration.png" alt-text="Screenshot of the Windows Search UI with 3rd party search provider integration.":::
 
-Search providers integrate with the Search experience by creating an [MSIX package](/windows/msix/) with a package manifest file that provides the required information for the OS to register the search provider. Users can add a search provider to Windows by installing the associated app package and can remove the search provider through the **Add or remove programs** page in Windows Settings app.
+Search providers integrate with the Search experience by creating an [MSIX package](/windows/msix/) with a package manifest file that provides the required information for the OS to register the search provider. After installation, the search provider is enabled by default in Windows Search experiences. In the Windows Settings app, users can enable and disable installed search providers and manage the order of providers in search results. Users can remove a search provider through the **Settings > Apps > Installed apps** page in Windows Settings app.
 
 For development and testing, when Developer Mode is enabled and the search provider app has been sideloaded on the device, it will appear in the list of available search providers. For more information, see [Developer Mode features and debugging](/windows/apps/get-started/developer-mode-features-and-debugging).
 
@@ -66,7 +61,7 @@ The protocol schema that will be used when launching the provided web search res
 
 #### DynamicContentEndpoint
 
-The URL of the HTTPS endpoint to which the OS will send a request for the gleam icon to be displayed in the search box. For more information see [Implement a gleam icon endpoint](#implement-a-gleam-icon-endpoint). This feature is supported starting with Windows 10 build 19045.4233 and Windows 11 build 22621.3371. 
+This feature is no longer supported. For more information see [Implement a gleam icon endpoint](#implement-a-gleam-icon-endpoint). The URL of the HTTPS endpoint to which the OS will send a request for the gleam icon to be displayed in the search box.  
 
 
 ### Example package manifest file
@@ -174,6 +169,9 @@ Search providers must support the OPTIONS request method and respond to this req
 
 ## Implement a gleam icon endpoint
 
+> [!NOTE]
+> This gleam feature is no longer enabled. Gleam icons are no longer displayed for all web providers in the EEA. The content in this section of the documentation is obsolete.
+
 Search providers can optionally provide light and dark mode gleam icons that are displayed in the search bar when the search provider is currently enabled. When the **DynamicContentEndpoint** element is provided in the app manifest, a request will be sent to the specified URL and the search provider responds with a json file in the format defined below that includes the URLs of the icon image files and other metadata. The gleam icon request will be sent periodically while the search provider is the most recent provider active in Windows Search. The cadence for this request is every 6 hours. A request will also be sent upon each Search launch and on device unlock.
 
 ### Gleam icon HTTPS request format

hub/apps/develop/search/search-providers.md

@@ -294,7 +294,12 @@ items:
                 - name: Test your app's signature with Smart App Control
                   href: develop/smart-app-control/test-your-app-with-smart-app-control.md
             - name: Windows Search
-              href: develop/search/search-providers.md
+              href: develop/search/index.md
+              items:
+                - name: Windows Search web search providers
+                  href: develop/search/search-providers.md
+                - name: Cloud files provider integration with Windows Search
+                  href: develop/search/cloud-search-integration.md
             - name: Windows Share
               items:
                 - name: Overview