Merge pull request #6997 from bjarnef/patch-29

Add info about `IPublishedContentQuery` in background task

Author: eshanrnh

15/umbraco-cms/implementation/services/README.md

@@ -223,6 +223,10 @@ public class HandleUnPublishingHandler : INotificationHandler<ContentUnpublished
 }
 ```
 
+#### Accessing the Published Content Cache via IPublishedContentQuery
+
+When fetching multiple content items by ID, using `UmbracoContext.Content` is limited because it only allows retrieving one item at a time. To query multiple items efficiently, you can use `IPublishedContentQuery`. For more details, see the [IPublishedContentQuery](../../reference/querying/ipublishedcontentquery.md) article.
+
 #### Accessing the Published Content Cache from a Content Finder / UrlProvider
 
 Inside a ContentFinder access to the content cache is possible by injecting `IUmbracoContextAccessor` into the constructor and provided via the PublishedRequest object:

15/umbraco-cms/reference/querying/ipublishedcontentquery.md

@@ -8,7 +8,7 @@ The `IPublishedContentQuery` interface contains different query methods for acce
 
 ## How to inject IPublishedContentQuery
 
-In order to inject the `IPublishedContentQuery` into your services, you must add a using statement for `Umbraco.Cms.Core` and inject the service using the constructor.
+To inject the `IPublishedContentQuery` into your services, you must add a using statement for `Umbraco.Cms.Core` and inject the service using the constructor.
 
 ```csharp
 using Umbraco.Cms.Core;
@@ -26,7 +26,23 @@ public class SearchService
 }
 ```
 
-Now you can access the `IPublishedContentQuery` through `_publishedContentQuery`
+Now you can access the `IPublishedContentQuery` through `_publishedContentQuery`.
+
+## Accessing the Published Content Cache via `IPublishedContentQuery`
+
+Sometimes, you may need to fetch multiple content items by ID, but `UmbracoContext.Content` only allows fetching a single content item at a time.  
+
+{% hint style="warning" %}
+In a background task, accessing the content cache using an injected `IPublishedContentQuery` or `IPublishedContentQueryAccessor` will not work, as they rely on `HttpContext`.  
+{% endhint %}
+
+Instead, use the following approach:  
+
+```csharp
+using UmbracoContextReference _ = _umbracoContextFactory.EnsureUmbracoContext();
+using IServiceScope serviceScope = _serviceProvider.CreateScope();
+IPublishedContentQuery query = serviceScope.ServiceProvider.GetRequiredService<IPublishedContentQuery>();
+```
 
 ## Examples