docs: create returns from storefront tutorial (#13522)

* docs: create returns from storefront tutorial

* small change

* generate llms

* add location ID

www/apps/resources/generated/edit-dates.mjs

@@ -6609,5 +6609,6 @@ export const generatedEditDates = {
   "references/core_flows/Locking/Steps_Locking/variables/core_flows.Locking.Steps_Locking.acquireLockStepId/page.mdx": "2025-09-15T09:52:14.218Z",
   "references/core_flows/Locking/Steps_Locking/variables/core_flows.Locking.Steps_Locking.releaseLockStepId/page.mdx": "2025-09-15T09:52:14.219Z",
   "references/core_flows/Locking/core_flows.Locking.Steps_Locking/page.mdx": "2025-09-15T09:52:14.217Z",
+  "app/nextjs-starter/guides/storefront-returns/page.mdx": "2025-09-22T06:02:00.580Z",
   "references/js_sdk/admin/Admin/properties/js_sdk.admin.Admin.views/page.mdx": "2025-09-18T17:04:59.240Z"
 }

www/apps/resources/generated/files-map.mjs

@@ -1019,6 +1019,10 @@ export const filesMap = [
     "filePath": "/www/apps/resources/app/nextjs-starter/guides/revalidate-cache/page.mdx",
     "pathname": "/nextjs-starter/guides/revalidate-cache"
   },
+  {
+    "filePath": "/www/apps/resources/app/nextjs-starter/guides/storefront-returns/page.mdx",
+    "pathname": "/nextjs-starter/guides/storefront-returns"
+  },
   {
     "filePath": "/www/apps/resources/app/nextjs-starter/page.mdx",
     "pathname": "/nextjs-starter"

www/apps/resources/generated/generated-commerce-modules-sidebar.mjs

@@ -6310,6 +6310,14 @@ const generatedgeneratedCommerceModulesSidebarSidebar = {
               "title": "Order Confirmation in Storefront",
               "path": "https://docs.medusajs.com/resources/storefront-development/checkout/order-confirmation",
               "children": []
+            },
+            {
+              "loaded": true,
+              "isPathHref": true,
+              "type": "ref",
+              "title": "Return Request - Order #",
+              "path": "https://docs.medusajs.com/resources/nextjs-starter/guides/storefront-returns",
+              "children": []
             }
           ]
         },

www/apps/resources/generated/generated-storefront-development-sidebar.mjs

@@ -51,6 +51,14 @@ const generatedgeneratedStorefrontDevelopmentSidebarSidebar = {
           "path": "/storefront-development/guides/express-checkout",
           "title": "Express Checkout Storefront",
           "children": []
+        },
+        {
+          "loaded": true,
+          "isPathHref": true,
+          "type": "ref",
+          "path": "/nextjs-starter/guides/storefront-returns",
+          "title": "Create Returns from Storefront",
+          "children": []
         }
       ]
     },

www/apps/resources/generated/generated-tools-sidebar.mjs

@@ -794,14 +794,6 @@ const generatedgeneratedToolsSidebarSidebar = {
               "title": "How-to Guides",
               "initialOpen": true,
               "children": [
-                {
-                  "loaded": true,
-                  "isPathHref": true,
-                  "type": "link",
-                  "path": "/nextjs-starter/guides/customize-stripe",
-                  "title": "Use Stripe's Payment Element",
-                  "children": []
-                },
                 {
                   "loaded": true,
                   "isPathHref": true,
@@ -829,6 +821,14 @@ const generatedgeneratedToolsSidebarSidebar = {
                   "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/gift-message",
                   "children": []
                 },
+                {
+                  "loaded": true,
+                  "isPathHref": true,
+                  "type": "link",
+                  "path": "/nextjs-starter/guides/storefront-returns",
+                  "title": "Create Order Returns",
+                  "children": []
+                },
                 {
                   "loaded": true,
                   "isPathHref": true,
@@ -876,6 +876,14 @@ const generatedgeneratedToolsSidebarSidebar = {
                   "title": "Ticket Booking Storefront",
                   "path": "https://docs.medusajs.com/resources/recipes/ticket-booking/example/storefront",
                   "children": []
+                },
+                {
+                  "loaded": true,
+                  "isPathHref": true,
+                  "type": "link",
+                  "path": "/nextjs-starter/guides/customize-stripe",
+                  "title": "Use Stripe's Payment Element",
+                  "children": []
                 }
               ]
             }

www/apps/resources/sidebars/storefront.mjs

@@ -35,6 +35,11 @@ export const storefrontDevelopmentSidebar = [
         path: "/storefront-development/guides/express-checkout",
         title: "Express Checkout Storefront",
       },
+      {
+        type: "ref",
+        path: "/nextjs-starter/guides/storefront-returns",
+        title: "Create Returns from Storefront",
+      },
     ],
   },
   {

www/apps/resources/sidebars/tools.mjs

@@ -108,11 +108,6 @@ export const toolsSidebar = [
             title: "How-to Guides",
             initialOpen: true,
             children: [
-              {
-                type: "link",
-                path: "/nextjs-starter/guides/customize-stripe",
-                title: "Use Stripe's Payment Element",
-              },
               {
                 type: "link",
                 path: "/nextjs-starter/guides/revalidate-cache",
@@ -126,6 +121,18 @@ export const toolsSidebar = [
             autogenerate_tags: "nextjs+tutorial",
             autogenerate_as_ref: true,
             sort_sidebar: "alphabetize",
+            children: [
+              {
+                type: "link",
+                path: "/nextjs-starter/guides/customize-stripe",
+                title: "Use Stripe's Payment Element",
+              },
+              {
+                type: "link",
+                path: "/nextjs-starter/guides/storefront-returns",
+                title: "Create Order Returns",
+              },
+            ],
           },
         ],
       },

www/packages/tags/src/tags/example.ts

@@ -1,4 +1,8 @@
 export const example = [
+  {
+    "title": "Return Request - Order #",
+    "path": "https://docs.medusajs.com/resources/nextjs-starter/guides/storefront-returns"
+  },
   {
     "title": "Implement Express Checkout with Medusa",
     "path": "https://docs.medusajs.com/resources/storefront-development/guides/express-checkout"

www/packages/tags/src/tags/order.ts

@@ -75,6 +75,10 @@ export const order = [
     "title": "Implement Re-Order",
     "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/re-order"
   },
+  {
+    "title": "Return Request - Order #",
+    "path": "https://docs.medusajs.com/resources/nextjs-starter/guides/storefront-returns"
+  },
   {
     "title": "Checkout Step 5: Complete Cart",
     "path": "https://docs.medusajs.com/resources/storefront-development/checkout/complete-cart"

www/packages/tags/src/tags/storefront.ts

@@ -3,6 +3,10 @@ export const storefront = [
     "title": "Use Stripe's Payment Element in the Next.js Starter Storefront",
     "path": "https://docs.medusajs.com/resources/nextjs-starter/guides/customize-stripe"
   },
+  {
+    "title": "Return Request - Order #",
+    "path": "https://docs.medusajs.com/resources/nextjs-starter/guides/storefront-returns"
+  },
   {
     "title": "Create Cart Context in Storefront",
     "path": "https://docs.medusajs.com/resources/storefront-development/cart/context"