From 64eecb5d13e563e4109cf60cd29a7313e0c50dba Mon Sep 17 00:00:00 2001
From: Bjarne Fyrstenborg <bjarne_fyrstenborg@hotmail.com>
Date: Wed, 2 Apr 2025 12:48:49 +0200
Subject: [PATCH 1/2] Add info about IPublishedContentQuery in background task

---
 15/umbraco-cms/implementation/services/README.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/15/umbraco-cms/implementation/services/README.md b/15/umbraco-cms/implementation/services/README.md
index 1b2497ae0d1..e3a00374737 100644
--- a/15/umbraco-cms/implementation/services/README.md
+++ b/15/umbraco-cms/implementation/services/README.md
@@ -223,6 +223,19 @@ public class HandleUnPublishingHandler : INotificationHandler<ContentUnpublished
 }
 ```
 
+#### Accessing the Published Content Cache via IPublishedContentQuery
+{% hint style="warning" %}
+Sometimes you may want to fetch multiple content items from ids, where `UmbracoContext.Content` only allow to fetch a single content item by id.
+However in a background task accessing content cache from injected `IPublishedContentQuery` or `IPublishedContentQueryAccessor` won't work as these rely on `HttpContext`.
+Innstead the following can be used.
+{% endhint %}
+
+```csharp
+using UmbracoContextReference _ = _umbracoContextFactory.EnsureUmbracoContext();
+using IServiceScope serviceScope = _serviceProvider.CreateScope();
+IPublishedContentQuery query = serviceScope.ServiceProvider.GetRequiredService<IPublishedContentQuery>();
+```
+
 #### 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:

From 306a8c640e269a1893682153bf5d15013c45793e Mon Sep 17 00:00:00 2001
From: Bjarne Fyrstenborg <bjarne_fyrstenborg@hotmail.com>
Date: Thu, 3 Apr 2025 15:42:12 +0200
Subject: [PATCH 2/2] Update 15/umbraco-cms/implementation/services/README.md

Co-authored-by: Esha Noronha <82437098+eshanrnh@users.noreply.github.com>
---
 15/umbraco-cms/implementation/services/README.md | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/15/umbraco-cms/implementation/services/README.md b/15/umbraco-cms/implementation/services/README.md
index e3a00374737..d5099cc2b17 100644
--- a/15/umbraco-cms/implementation/services/README.md
+++ b/15/umbraco-cms/implementation/services/README.md
@@ -224,12 +224,14 @@ public class HandleUnPublishingHandler : INotificationHandler<ContentUnpublished
 ```
 
 #### 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" %}
-Sometimes you may want to fetch multiple content items from ids, where `UmbracoContext.Content` only allow to fetch a single content item by id.
-However in a background task accessing content cache from injected `IPublishedContentQuery` or `IPublishedContentQueryAccessor` won't work as these rely on `HttpContext`.
-Innstead the following can be used.
+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();