Merge pull request #6732 from umbraco/update-property-editor

Update mediapicker article with an example

Author: eshanrnh

13/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/media-picker-3.md

@@ -4,7 +4,10 @@
 
 `Returns: IEnumerable<MediaWithCrops>` or `MediaWithCrops`
 
-This property editors returns a single `MediaWithCrops` item if the "Pick multiple items" Data Type setting is disabled or a collection if it is enabled.
+This property editors returns one of the following:
+
+- A collection (`IEnumerable<MediaWithCrops>`) if the **Pick multiple items** setting is enabled.
+- A single `MediaWithCrops` item if the **Pick multiple items** setting is disabled.
 
 ## Data Type Definition Example
 
@@ -71,6 +74,23 @@ Global crops are configured on the Image Cropper property of the Image Media Typ
 }
 ```
 
+#### Multiple enabled without Modelsbuilder to retrieve IEnumerable<IPublishedContent> data
+
+```csharp
+@using Umbraco.Cms.Core.Models
+@{
+    var listOfImages = Model.Value<IEnumerable<IPublishedContent>>("medias");
+    foreach (var image in listOfImages)
+    {
+        <img src="@image.Url()" alt="@image.Name" />
+    }
+}
+```
+
+{% hint style="info" %}
+While `MediaWithCrops` is the default return type, `IPublishedContent` may be used in backward-compatible implementations or when working directly with core APIs.
+{% endhint %}
+
 ### Multiple enabled with Modelsbuilder
 
 ```csharp

14/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/media-picker-3.md

@@ -6,7 +6,10 @@
 
 `Returns: IEnumerable<MediaWithCrops>` or `MediaWithCrops`
 
-This property editors returns a single `MediaWithCrops` item if the "Pick multiple items" Data Type setting is disabled or a collection if it is enabled.
+This property editors returns one of the following:
+
+- A collection (`IEnumerable<MediaWithCrops>`) if the **Pick multiple items** setting is enabled.
+- A single `MediaWithCrops` item if the **Pick multiple items** setting is disabled.
 
 ## Data Type Definition Example
 
@@ -73,6 +76,23 @@ Global crops are configured on the Image Cropper property of the Image Media Typ
 }
 ```
 
+#### Multiple enabled without Modelsbuilder to retrieve IEnumerable<IPublishedContent> data
+
+```csharp
+@using Umbraco.Cms.Core.Models
+@{
+    var listOfImages = Model.Value<IEnumerable<IPublishedContent>>("medias");
+    foreach (var image in listOfImages)
+    {
+        <img src="@image.Url()" alt="@image.Name" />
+    }
+}
+```
+
+{% hint style="info" %}
+While `MediaWithCrops` is the default return type, `IPublishedContent` may be used in backward-compatible implementations or when working directly with core APIs.
+{% endhint %}
+
 ### Multiple enabled with Modelsbuilder
 
 ```csharp

15/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/media-picker-3.md

@@ -6,7 +6,10 @@
 
 `Returns: IEnumerable<MediaWithCrops>` or `MediaWithCrops`
 
-This property editors returns a single `MediaWithCrops` item if the "Pick multiple items" Data Type setting is disabled or a collection if it is enabled.
+This property editors returns one of the following:
+
+- A collection (`IEnumerable<MediaWithCrops>`) if the **Pick multiple items** setting is enabled.
+- A single `MediaWithCrops` item if the **Pick multiple items** setting is disabled.
 
 ## Data Type Definition Example
 
@@ -73,6 +76,23 @@ Global crops are configured on the Image Cropper property of the Image Media Typ
 }
 ```
 
+#### Multiple enabled without Modelsbuilder to retrieve IEnumerable<IPublishedContent> data
+
+```csharp
+@using Umbraco.Cms.Core.Models
+@{
+    var listOfImages = Model.Value<IEnumerable<IPublishedContent>>("medias");
+    foreach (var image in listOfImages)
+    {
+        <img src="@image.Url()" alt="@image.Name" />
+    }
+}
+```
+
+{% hint style="info" %}
+While `MediaWithCrops` is the default return type, `IPublishedContent` may be used in backward-compatible implementations or when working directly with core APIs.
+{% endhint %}
+
 ### Multiple enabled with Modelsbuilder
 
 ```csharp