diff --git a/www/apps/book/public/llms-full.txt b/www/apps/book/public/llms-full.txt
index b57df33b7d..f3a40cba75 100644
--- a/www/apps/book/public/llms-full.txt
+++ b/www/apps/book/public/llms-full.txt
@@ -29553,25 +29553,31 @@ Learn more about workflows in [this documentation](https://docs.medusajs.com/doc
# Configure Selling Products
-In this guide, you'll learn how to set up and configure your products based on their shipping and inventory requirements, the product type, how you want to sell them, or your commerce ecosystem.
+In this guide, you'll learn how to set up and configure your products based on their shipping and inventory requirements, their type, how you want to sell them, or your commerce ecosystem.
-The concepts in this guide are applicable starting from Medusa v2.5.1.
+The concepts in this guide are applicable starting from [Medusa v2.5.1](https://github.com/medusajs/medusa/releases/tag/v2.5.1).
## Scenario
-Businesses can have different selling requirements:
+Businesses can have different selling requirements. They may sell:
-1. They may sell physical or digital items.
-2. They may sell items that don't require shipping or inventory management, such as selling digital products, services, or booking appointments.
-3. They may sell items whose inventory is managed by an external system, such as an ERP.
+1. Physical or digital items.
+2. Items that don't require shipping or inventory management, such as selling digital products, services, or booking appointments.
+3. Items whose inventory is managed by an external system, such as an ERP.
-Medusa supports these different selling requirements by allowing you to configure shipping and inventory requirements for products and their variants. This guide explains how these configurations work, then provides examples of setting up different use cases.
+Medusa supports these different selling requirements by allowing you to configure shipping and inventory requirements for products and their variants.
+
+This guide explains how these configurations work, then provides examples of setting up different use cases.
***
## Configuring Shipping Requirements
-The Medusa application defines a link between the `Product` data model and a [ShippingProfile](https://docs.medusajs.com/Users/shahednasser/medusa/www/apps/resources/app/commerce-modules/fulfillment/concepts#shipping-profile/index.html.md) in the [Fulfillment Module](https://docs.medusajs.com/Users/shahednasser/medusa/www/apps/resources/app/commerce-modules/fulfillment/index.html.md), allowing you to associate a product with a shipping profile.
+### Product Shipping Requirement
+
+The Medusa application defines a link between the `Product` data model and the [ShippingProfile](https://docs.medusajs.com/Users/shahednasser/medusa/www/apps/resources/app/commerce-modules/fulfillment/concepts#shipping-profile/index.html.md) data model in the [Fulfillment Module](https://docs.medusajs.com/Users/shahednasser/medusa/www/apps/resources/app/commerce-modules/fulfillment/index.html.md), allowing you to associate a product with a shipping profile.
+
+
When a product is associated with a shipping profile, its variants require shipping and fulfillment when purchased. This is useful for physical products or digital products that require custom fulfillment.
@@ -29579,15 +29585,32 @@ If a product doesn't have an associated shipping profile, its variants don't req
### Overriding Shipping Requirements for Variants
-A product variant whose inventory is managed by Medusa (its `manage_inventory` property is enabled) has an [inventory item](https://docs.medusajs.com/Users/shahednasser/medusa/www/apps/resources/app/commerce-modules/inventory/concepts#inventoryitem/index.html.md). The inventory item has a `requires_shipping` property that can be used to override its shipping requirement. This is useful if the product has an associated shipping profile but you want to disable shipping for a specific variant, or vice versa.
+A product variant whose inventory is managed by Medusa (its `manage_inventory` property is enabled) has an [inventory item](https://docs.medusajs.com/Users/shahednasser/medusa/www/apps/resources/app/commerce-modules/inventory/concepts#inventoryitem/index.html.md).
-Learn more about product variant's inventory in [this guide](https://docs.medusajs.com/Users/shahednasser/medusa/www/apps/resources/app/commerce-modules/product/variant-inventory/index.html.md).
+The inventory item has a `requires_shipping` property that can be used to override the variant's shipping requirement. This is useful if the product has an associated shipping profile but you want to disable shipping for a specific variant, or vice versa.
-When a product variant is purchased, the Medusa application decides whether the purchased item requires shipping in the following order:
+
-1. The product variant has an inventory item. In this case, the Medusa application uses the inventory item's `requires_shipping` property to determine if the item requires shipping.
+Refer to the [Product Variant Inventory](https://docs.medusajs.com/Users/shahednasser/medusa/www/apps/resources/app/commerce-modules/product/variant-inventory/index.html.md) guide to learn more.
+
+When a product variant is purchased, the Medusa application decides whether the purchased item requires shipping based on the following conditions (in the following order):
+
+1. If the product variant has an inventory item, the Medusa application uses the inventory item's `requires_shipping` property to determine if the item requires shipping.
2. If the product variant doesn't have an inventory item, the Medusa application checks whether the product has an associated shipping profile to determine if the item requires shipping.
+
+
+### Shipping Requirements vs Shipping Options
+
+The shipping options that you retrieve during checkout depend on the cart's shipping address. So, whether the items in the cart require shipping doesn't affect what shipping options are available at checkout.
+
+This is a common misconception, where you expect to not receive any shipping options at checkout if the cart doesn't have any items that require shipping. However, the Medusa application always returns shipping options based on the cart's shipping address.
+
+If you want to show the shipping options only if the cart has items that require shipping, you can either:
+
+- Create a custom [API route](https://docs.medusajs.com/docs/learn/fundamentals/api-routes/index.html.md) that checks whether the cart has items that require shipping.
+- Perform this check in your storefront's frontend code, such as in the checkout page, and show or hide the shipping options accordingly.
+
***
## Use Case Examples
diff --git a/www/apps/resources/app/commerce-modules/product/selling-products/page.mdx b/www/apps/resources/app/commerce-modules/product/selling-products/page.mdx
index 3a189a2f37..466ce7c4ed 100644
--- a/www/apps/resources/app/commerce-modules/product/selling-products/page.mdx
+++ b/www/apps/resources/app/commerce-modules/product/selling-products/page.mdx
@@ -5,6 +5,8 @@ tags:
- fulfillment
products:
- fulfillment
+ - product
+ - inventory
---
import { Table } from "docs-ui"
@@ -15,29 +17,35 @@ export const metadata = {
# {metadata.title}
-In this guide, you'll learn how to set up and configure your products based on their shipping and inventory requirements, the product type, how you want to sell them, or your commerce ecosystem.
+In this guide, you'll learn how to set up and configure your products based on their shipping and inventory requirements, their type, how you want to sell them, or your commerce ecosystem.
-The concepts in this guide are applicable starting from Medusa v2.5.1.
+The concepts in this guide are applicable starting from [Medusa v2.5.1](https://github.com/medusajs/medusa/releases/tag/v2.5.1).
## Scenario
-Businesses can have different selling requirements:
+Businesses can have different selling requirements. They may sell:
-1. They may sell physical or digital items.
-2. They may sell items that don't require shipping or inventory management, such as selling digital products, services, or booking appointments.
-3. They may sell items whose inventory is managed by an external system, such as an ERP.
+1. Physical or digital items.
+2. Items that don't require shipping or inventory management, such as selling digital products, services, or booking appointments.
+3. Items whose inventory is managed by an external system, such as an ERP.
-Medusa supports these different selling requirements by allowing you to configure shipping and inventory requirements for products and their variants. This guide explains how these configurations work, then provides examples of setting up different use cases.
+Medusa supports these different selling requirements by allowing you to configure shipping and inventory requirements for products and their variants.
+
+This guide explains how these configurations work, then provides examples of setting up different use cases.
---
## Configuring Shipping Requirements
-The Medusa application defines a link between the `Product` data model and a [ShippingProfile](../../fulfillment/concepts/page.mdx#shipping-profile) in the [Fulfillment Module](../../fulfillment/page.mdx), allowing you to associate a product with a shipping profile.
+### Product Shipping Requirement
+
+The Medusa application defines a link between the `Product` data model and the [ShippingProfile](../../fulfillment/concepts/page.mdx#shipping-profile) data model in the [Fulfillment Module](../../fulfillment/page.mdx), allowing you to associate a product with a shipping profile.
+
+
When a product is associated with a shipping profile, its variants require shipping and fulfillment when purchased. This is useful for physical products or digital products that require custom fulfillment.
@@ -45,19 +53,36 @@ If a product doesn't have an associated shipping profile, its variants don't req
### Overriding Shipping Requirements for Variants
-A product variant whose inventory is managed by Medusa (its `manage_inventory` property is enabled) has an [inventory item](../../inventory/concepts/page.mdx#inventoryitem). The inventory item has a `requires_shipping` property that can be used to override its shipping requirement. This is useful if the product has an associated shipping profile but you want to disable shipping for a specific variant, or vice versa.
+A product variant whose inventory is managed by Medusa (its `manage_inventory` property is enabled) has an [inventory item](../../inventory/concepts/page.mdx#inventoryitem).
+
+The inventory item has a `requires_shipping` property that can be used to override the variant's shipping requirement. This is useful if the product has an associated shipping profile but you want to disable shipping for a specific variant, or vice versa.
+
+
-Learn more about product variant's inventory in [this guide](../variant-inventory/page.mdx).
+Refer to the [Product Variant Inventory](../variant-inventory/page.mdx) guide to learn more.
-When a product variant is purchased, the Medusa application decides whether the purchased item requires shipping in the following order:
+When a product variant is purchased, the Medusa application decides whether the purchased item requires shipping based on the following conditions (in the following order):
-1. The product variant has an inventory item. In this case, the Medusa application uses the inventory item's `requires_shipping` property to determine if the item requires shipping.
+1. If the product variant has an inventory item, the Medusa application uses the inventory item's `requires_shipping` property to determine if the item requires shipping.
2. If the product variant doesn't have an inventory item, the Medusa application checks whether the product has an associated shipping profile to determine if the item requires shipping.
+
+
+### Shipping Requirements vs Shipping Options
+
+The shipping options that you retrieve during checkout depend on the cart's shipping address. So, whether the items in the cart require shipping doesn't affect what shipping options are available at checkout.
+
+This is a common misconception, where you expect to not receive any shipping options at checkout if the cart doesn't have any items that require shipping. However, the Medusa application always returns shipping options based on the cart's shipping address.
+
+If you want to show the shipping options only if the cart has items that require shipping, you can either:
+
+- Create a custom [API route](!docs!/learn/fundamentals/api-routes) that checks whether the cart has items that require shipping.
+- Perform this check in your storefront's frontend code, such as in the checkout page, and show or hide the shipping options accordingly.
+
---
## Use Case Examples
diff --git a/www/apps/resources/generated/edit-dates.mjs b/www/apps/resources/generated/edit-dates.mjs
index f521126c1e..586a24562b 100644
--- a/www/apps/resources/generated/edit-dates.mjs
+++ b/www/apps/resources/generated/edit-dates.mjs
@@ -5904,7 +5904,7 @@ export const generatedEditDates = {
"references/utils/enums/utils.PaymentCollectionStatus/page.mdx": "2025-04-11T09:04:53.005Z",
"app/recipes/erp/page.mdx": "2025-05-20T07:51:40.720Z",
"app/recipes/erp/odoo/page.mdx": "2025-05-20T07:51:40.720Z",
- "app/commerce-modules/product/selling-products/page.mdx": "2025-02-13T13:27:09.270Z",
+ "app/commerce-modules/product/selling-products/page.mdx": "2025-07-18T08:56:24.231Z",
"references/js_sdk/admin/Admin/properties/js_sdk.admin.Admin.draftOrder/page.mdx": "2025-06-25T10:11:46.807Z",
"references/js_sdk/admin/Client/methods/js_sdk.admin.Client.throwError_/page.mdx": "2025-02-24T10:48:47.018Z",
"references/js_sdk/admin/CustomStorage/methods/js_sdk.admin.CustomStorage.getItem/page.mdx": "2025-02-24T10:48:47.069Z",
diff --git a/www/apps/resources/generated/generated-commerce-modules-sidebar.mjs b/www/apps/resources/generated/generated-commerce-modules-sidebar.mjs
index 8570cbeeea..d7f28261b9 100644
--- a/www/apps/resources/generated/generated-commerce-modules-sidebar.mjs
+++ b/www/apps/resources/generated/generated-commerce-modules-sidebar.mjs
@@ -6102,6 +6102,14 @@ const generatedgeneratedCommerceModulesSidebarSidebar = {
"path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/loyalty-points",
"children": []
},
+ {
+ "loaded": true,
+ "isPathHref": true,
+ "type": "ref",
+ "title": "Implement Pre-Orders",
+ "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/preorder",
+ "children": []
+ },
{
"loaded": true,
"isPathHref": true,
@@ -11477,6 +11485,14 @@ const generatedgeneratedCommerceModulesSidebarSidebar = {
"path": "https://docs.medusajs.com/resources/examples/guides/custom-item-price",
"children": []
},
+ {
+ "loaded": true,
+ "isPathHref": true,
+ "type": "ref",
+ "title": "Implement Pre-Order Products",
+ "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/preorder",
+ "children": []
+ },
{
"loaded": true,
"isPathHref": true,
diff --git a/www/apps/resources/generated/generated-tools-sidebar.mjs b/www/apps/resources/generated/generated-tools-sidebar.mjs
index 722d79e332..600c14d321 100644
--- a/www/apps/resources/generated/generated-tools-sidebar.mjs
+++ b/www/apps/resources/generated/generated-tools-sidebar.mjs
@@ -819,6 +819,14 @@ const generatedgeneratedToolsSidebarSidebar = {
"path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/first-purchase-discounts",
"children": []
},
+ {
+ "loaded": true,
+ "isPathHref": true,
+ "type": "ref",
+ "title": "Implement Pre-Orders",
+ "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/preorder",
+ "children": []
+ },
{
"loaded": true,
"isPathHref": true,