docs: strapi integration guide (#14075)

2025-12-02 12:30:47 +02:00
parent 92769b2b1c
commit 0158554020
12 changed files with 8106 additions and 10 deletions
@@ -785,7 +785,7 @@ export default buildConfig({
 })
 ```

-## i. Generate Payload Imports Map
+### i. Generate Payload Imports Map

 Before running the Payload admin, you need to generate the imports map that Payload uses to resolve the collections and other configurations.

@@ -797,7 +797,7 @@ npx payload generate:importmap

 This command generates the `src/app/(payload)/admin/importMap.js` file that Payload needs.

-## j. Run the Payload Admin
+### j. Run the Payload Admin

 You can now run the Payload admin in the Next.js Starter Storefront and create an admin user.

@@ -1977,7 +1977,7 @@ Then, create a product in Medusa using the Medusa Admin. If you check the Produc

 Now that you've integrated Payload with Medusa, you can customize the Next.js Starter Storefront to display product content from Payload. By doing so, you can show product content and assets that are optimized for the storefront.

-In this step, you'll customize the Next.js Starter Storefront to view the product title, description, images, and option values from Payload.
+In this step, you'll customize the Next.js Starter Storefront to show the product title, description, images, and option values from Payload.

 ### a. Fetch Payload Data with Product Data

@@ -3544,7 +3544,7 @@ You've successfully integrated Medusa with Payload to manage content related to
 2. Enable [localization](https://payloadcms.com/docs/configuration/localization) in Payload to support multiple languages.
    - You only need to manage the localized content in Payload. Only the default locale will be synced with Medusa.
    - You can show the localized content in your Next.js Starter Storefront based on the customer's locale.
-3. Add custom fields to the Payload collections. For example, you can add images to product variants and display them in the Next.js Starter Storefront.
+3. Add custom fields to the Payload collections that are relevant for the storefront, such as SEO metadata or promotional banners.

 ### Learn More about Medusa

@@ -94,6 +94,14 @@ Integrate a third-party Content-Management System (CMS) to utilize rich content-
        children: "Tutorial"
      }
    },
+    {
+      href: "/integrations/guides/strapi",
+      title: "Strapi",
+      badge: {
+        variant: "blue",
+        children: "Tutorial"
+      }
+    }
  ]}
  className="mb-1"
  itemsPerRow={2}
@@ -103,7 +103,7 @@ export const generatedEditDates = {
  "app/deployment/admin/vercel/page.mdx": "2024-10-16T08:10:29.377Z",
  "app/deployment/storefront/vercel/page.mdx": "2025-05-20T07:51:40.712Z",
  "app/deployment/page.mdx": "2025-09-29T10:23:47.833Z",
-  "app/integrations/page.mdx": "2025-10-22T07:14:23.467Z",
+  "app/integrations/page.mdx": "2025-11-17T09:41:11.910Z",
  "app/medusa-cli/page.mdx": "2024-08-28T11:25:32.382Z",
  "app/medusa-container-resources/page.mdx": "2025-07-31T13:24:15.786Z",
  "app/medusa-workflows-reference/page.mdx": "2025-01-20T08:21:29.962Z",
@@ -6738,5 +6738,6 @@ export const generatedEditDates = {
  "references/types/HttpTypes/interfaces/types.HttpTypes.AdminOrderChangeResponse/page.mdx": "2025-12-01T18:33:00.993Z",
  "references/types/HttpTypes/interfaces/types.HttpTypes.AdminUpdateOrderChange/page.mdx": "2025-12-01T18:33:00.960Z",
  "references/promotion/types/promotion.ComputeActions/page.mdx": "2025-12-01T18:33:06.048Z",
-  "references/utils/PromotionUtils/enums/utils.PromotionUtils.ComputedActions/page.mdx": "2025-12-01T18:33:07.491Z"
+  "references/utils/PromotionUtils/enums/utils.PromotionUtils.ComputedActions/page.mdx": "2025-12-01T18:33:07.491Z",
+  "app/integrations/guides/strapi/page.mdx": "2025-11-17T10:34:00.881Z"
 }
@@ -1007,6 +1007,10 @@ export const filesMap = [
    "filePath": "/www/apps/resources/app/integrations/guides/slack/page.mdx",
    "pathname": "/integrations/guides/slack"
  },
+  {
+    "filePath": "/www/apps/resources/app/integrations/guides/strapi/page.mdx",
+    "pathname": "/integrations/guides/strapi"
+  },
  {
    "filePath": "/www/apps/resources/app/integrations/page.mdx",
    "pathname": "/integrations"
@@ -11794,6 +11794,14 @@ const generatedgeneratedCommerceModulesSidebarSidebar = {
              "path": "https://docs.medusajs.com/resources/integrations/guides/payload",
              "children": []
            },
+            {
+              "loaded": true,
+              "isPathHref": true,
+              "type": "ref",
+              "title": "Integrate Strapi",
+              "path": "https://docs.medusajs.com/resources/integrations/guides/strapi",
+              "children": []
+            },
            {
              "loaded": true,
              "isPathHref": true,
@@ -93,6 +93,14 @@ const generatedgeneratedIntegrationsSidebarSidebar = {
          "path": "/integrations/guides/sanity",
          "title": "Sanity",
          "children": []
+        },
+        {
+          "loaded": true,
+          "isPathHref": true,
+          "type": "link",
+          "path": "/integrations/guides/strapi",
+          "title": "Strapi",
+          "children": []
        }
      ]
    },
@@ -62,6 +62,11 @@ export const integrationsSidebar = [
        path: "/integrations/guides/sanity",
        title: "Sanity",
      },
+      {
+        type: "link",
+        path: "/integrations/guides/strapi",
+        title: "Strapi",
+      },
    ],
  },
  {
@@ -107,6 +107,10 @@ export const product = [
    "title": "Integrate Payload",
    "path": "https://docs.medusajs.com/resources/integrations/guides/payload"
  },
+  {
+    "title": "Integrate Strapi",
+    "path": "https://docs.medusajs.com/resources/integrations/guides/strapi"
+  },
  {
    "title": "Build Wishlist Plugin",
    "path": "https://docs.medusajs.com/resources/plugins/guides/wishlist"
@@ -159,6 +159,10 @@ export const server = [
    "title": "Integrate Slack",
    "path": "https://docs.medusajs.com/resources/integrations/guides/slack"
  },
+  {
+    "title": "Integrate Strapi",
+    "path": "https://docs.medusajs.com/resources/integrations/guides/strapi"
+  },
  {
    "title": "Build Wishlist Plugin",
    "path": "https://docs.medusajs.com/resources/plugins/guides/wishlist"
@@ -107,6 +107,10 @@ export const tutorial = [
    "title": "Integrate Slack",
    "path": "https://docs.medusajs.com/resources/integrations/guides/slack"
  },
+  {
+    "title": "Integrate Strapi",
+    "path": "https://docs.medusajs.com/resources/integrations/guides/strapi"
+  },
  {
    "title": "Build Wishlist Plugin",
    "path": "https://docs.medusajs.com/resources/plugins/guides/wishlist"