From 1de6a563cc70ffd0b55b76f251b8bb9edabdb3ff Mon Sep 17 00:00:00 2001 From: Jesper Mayntzhusen <79840720+jemayn@users.noreply.github.com> Date: Mon, 1 Dec 2025 08:20:59 +0100 Subject: [PATCH 1/4] Add mention of extended IProductSnapshot interfaces --- 17/umbraco-commerce/key-concepts/product-adapters.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/17/umbraco-commerce/key-concepts/product-adapters.md b/17/umbraco-commerce/key-concepts/product-adapters.md index e0cb235d09e..8f0ad68c80d 100644 --- a/17/umbraco-commerce/key-concepts/product-adapters.md +++ b/17/umbraco-commerce/key-concepts/product-adapters.md @@ -71,6 +71,11 @@ public interface IProductSnapshot ``` +{% hint style="info" %} +`IProductSnapshot` is the base model for what Umbraco Commerce needs. If you want to include images or measurements (if you for example need to do shipping based on weight), then there are other extended IProductSnapshot interfaces you can return. +`IProductSnapshotWithImage`, `IProductSnapshotWithCategories` & `IProductSnapshotWithMeasurements` are all valid return types that allows you to enrich the product model. +{% endhint %} + ## Support editable carts To allow Umbraco Commerce to search for products/variants to add to a cart via the backoffice, Product Adapters can implement 3 additional methods. This can also be done to support editable carts. From fe129b63045321de1ab3e7d22c6cb97931f6aa71 Mon Sep 17 00:00:00 2001 From: Jesper Mayntzhusen <79840720+jemayn@users.noreply.github.com> Date: Mon, 1 Dec 2025 08:37:17 +0100 Subject: [PATCH 2/4] Update 17/umbraco-commerce/key-concepts/product-adapters.md --- 17/umbraco-commerce/key-concepts/product-adapters.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/17/umbraco-commerce/key-concepts/product-adapters.md b/17/umbraco-commerce/key-concepts/product-adapters.md index 8f0ad68c80d..1f8605ce5c3 100644 --- a/17/umbraco-commerce/key-concepts/product-adapters.md +++ b/17/umbraco-commerce/key-concepts/product-adapters.md @@ -72,7 +72,7 @@ public interface IProductSnapshot ``` {% hint style="info" %} -`IProductSnapshot` is the base model for what Umbraco Commerce needs. If you want to include images or measurements (if you for example need to do shipping based on weight), then there are other extended IProductSnapshot interfaces you can return. +`IProductSnapshot` is the base model for what Umbraco Commerce needs. If you want to include images or measurements (for example, if you need weight-based shipping), then there are other extended IProductSnapshot interfaces you can return. `IProductSnapshotWithImage`, `IProductSnapshotWithCategories` & `IProductSnapshotWithMeasurements` are all valid return types that allows you to enrich the product model. {% endhint %} From 02e4163d505201482faf83cb8c46205af1c4c59e Mon Sep 17 00:00:00 2001 From: Jesper Mayntzhusen <79840720+jemayn@users.noreply.github.com> Date: Mon, 1 Dec 2025 08:40:08 +0100 Subject: [PATCH 3/4] Update 17/umbraco-commerce/key-concepts/product-adapters.md --- 17/umbraco-commerce/key-concepts/product-adapters.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/17/umbraco-commerce/key-concepts/product-adapters.md b/17/umbraco-commerce/key-concepts/product-adapters.md index 1f8605ce5c3..8a3a7682943 100644 --- a/17/umbraco-commerce/key-concepts/product-adapters.md +++ b/17/umbraco-commerce/key-concepts/product-adapters.md @@ -72,7 +72,7 @@ public interface IProductSnapshot ``` {% hint style="info" %} -`IProductSnapshot` is the base model for what Umbraco Commerce needs. If you want to include images or measurements (for example, if you need weight-based shipping), then there are other extended IProductSnapshot interfaces you can return. +`IProductSnapshot` is the base model for what Umbraco Commerce needs. If you want to include images or measurements (for example, if you need weight-based shipping), then there are other interfaces you can return. `IProductSnapshotWithImage`, `IProductSnapshotWithCategories` & `IProductSnapshotWithMeasurements` are all valid return types that allows you to enrich the product model. {% endhint %} From a604e279471b14aa9d2e444c71767d374761d193 Mon Sep 17 00:00:00 2001 From: sofietoft Date: Fri, 9 Jan 2026 09:41:01 +0100 Subject: [PATCH 4/4] Update 17/umbraco-commerce/key-concepts/product-adapters.md --- 17/umbraco-commerce/key-concepts/product-adapters.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/17/umbraco-commerce/key-concepts/product-adapters.md b/17/umbraco-commerce/key-concepts/product-adapters.md index 8a3a7682943..2e0aca910bb 100644 --- a/17/umbraco-commerce/key-concepts/product-adapters.md +++ b/17/umbraco-commerce/key-concepts/product-adapters.md @@ -72,7 +72,7 @@ public interface IProductSnapshot ``` {% hint style="info" %} -`IProductSnapshot` is the base model for what Umbraco Commerce needs. If you want to include images or measurements (for example, if you need weight-based shipping), then there are other interfaces you can return. +`IProductSnapshot` is the base model for enriching the Umbraco Commerce product model. To include images or custom measurements, such as weight-based shipping, more specific interfaces are available. `IProductSnapshotWithImage`, `IProductSnapshotWithCategories` & `IProductSnapshotWithMeasurements` are all valid return types that allows you to enrich the product model. {% endhint %}