docs: category images guide (#13755)

* docs: category images guide

* added openapi spec

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

@@ -6618,6 +6618,7 @@ export const generatedEditDates = {
   "app/data-model-repository-reference/methods/upsertWithReplace/page.mdx": "2025-10-28T16:02:30.479Z",
   "app/how-to-tutorials/tutorials/agentic-commerce/page.mdx": "2025-10-09T11:25:48.831Z",
   "app/storefront-development/production-optimizations/page.mdx": "2025-10-03T13:28:37.909Z",
+  "app/how-to-tutorials/tutorials/category-images/page.mdx": "2025-10-15T08:57:05.566Z",
   "app/infrastructure-modules/caching/page.mdx": "2025-10-13T11:46:36.452Z",
   "app/troubleshooting/subscribers/not-working/page.mdx": "2025-10-16T09:25:57.376Z",
   "references/js_sdk/admin/RefundReason/methods/js_sdk.admin.RefundReason.create/page.mdx": "2025-10-21T08:10:56.630Z",

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

@@ -759,6 +759,10 @@ export const filesMap = [
     "filePath": "/www/apps/resources/app/how-to-tutorials/tutorials/agentic-commerce/page.mdx",
     "pathname": "/how-to-tutorials/tutorials/agentic-commerce"
   },
+  {
+    "filePath": "/www/apps/resources/app/how-to-tutorials/tutorials/category-images/page.mdx",
+    "pathname": "/how-to-tutorials/tutorials/category-images"
+  },
   {
     "filePath": "/www/apps/resources/app/how-to-tutorials/tutorials/first-purchase-discounts/page.mdx",
     "pathname": "/how-to-tutorials/tutorials/first-purchase-discounts"

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

@@ -11857,6 +11857,14 @@ const generatedgeneratedCommerceModulesSidebarSidebar = {
               "title": "Localization with Contentful",
               "path": "https://docs.medusajs.com/resources/integrations/guides/contentful",
               "children": []
+            },
+            {
+              "loaded": true,
+              "isPathHref": true,
+              "type": "ref",
+              "title": "Product Category Images",
+              "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/category-images",
+              "children": []
             }
           ]
         },

www/apps/resources/generated/generated-how-to-tutorials-sidebar.mjs

@@ -415,6 +415,15 @@ const generatedgeneratedHowToTutorialsSidebarSidebar = {
           "description": "Learn how to add a gift option and message to items in the cart.",
           "children": []
         },
+        {
+          "loaded": true,
+          "isPathHref": true,
+          "type": "link",
+          "title": "Add Product Category Images",
+          "path": "/how-to-tutorials/tutorials/category-images",
+          "description": "Learn how to add images to product categories in Medusa.",
+          "children": []
+        },
         {
           "loaded": true,
           "isPathHref": true,

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

@@ -861,6 +861,14 @@ const generatedgeneratedToolsSidebarSidebar = {
                   "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/product-builder",
                   "children": []
                 },
+                {
+                  "loaded": true,
+                  "isPathHref": true,
+                  "type": "ref",
+                  "title": "Megamenu and Category Banner",
+                  "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/category-images",
+                  "children": []
+                },
                 {
                   "loaded": true,
                   "isPathHref": true,

www/apps/resources/sidebars/how-to-tutorials.mjs

@@ -79,6 +79,12 @@ While tutorials show you a specific use case, they also help you understand how
         description:
           "Learn how to add a gift option and message to items in the cart.",
       },
+      {
+        type: "link",
+        title: "Add Product Category Images",
+        path: "/how-to-tutorials/tutorials/category-images",
+        description: "Learn how to add images to product categories in Medusa.",
+      },
       {
         type: "link",
         title: "Agentic Commerce",

www/packages/tags/src/tags/nextjs.ts

@@ -1,4 +1,8 @@
 export const nextjs = [
+  {
+    "title": "Megamenu and Category Banner",
+    "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/category-images"
+  },
   {
     "title": "First-Purchase Discount",
     "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/first-purchase-discounts"

www/packages/tags/src/tags/product.ts

@@ -75,6 +75,10 @@ export const product = [
     "title": "Implement Custom Line Item Pricing in Medusa",
     "path": "https://docs.medusajs.com/resources/examples/guides/custom-item-price"
   },
+  {
+    "title": "Product Category Images",
+    "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/category-images"
+  },
   {
     "title": "Implement Pre-Order Products",
     "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/preorder"

www/packages/tags/src/tags/server.ts

@@ -63,6 +63,10 @@ export const server = [
     "title": "Agentic Commerce",
     "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/agentic-commerce"
   },
+  {
+    "title": "Product Category Images",
+    "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/category-images"
+  },
   {
     "title": "First-Purchase Discount",
     "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/first-purchase-discounts"

www/packages/tags/src/tags/tutorial.ts

@@ -31,6 +31,10 @@ export const tutorial = [
     "title": "Agentic Commerce",
     "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/agentic-commerce"
   },
+  {
+    "title": "Product Category Images",
+    "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/category-images"
+  },
   {
     "title": "First-Purchase Discount",
     "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/first-purchase-discounts"