diff --git a/www/apps/book/app/learn/fundamentals/generated-types/page.mdx b/www/apps/book/app/learn/fundamentals/generated-types/page.mdx
new file mode 100644
index 0000000000..257eb9ac3a
--- /dev/null
+++ b/www/apps/book/app/learn/fundamentals/generated-types/page.mdx
@@ -0,0 +1,88 @@
+import { CodeTabs, CodeTab } from "docs-ui"
+
+export const metadata = {
+ title: `${pageNumber} Automatically Generated Types`,
+}
+
+# {metadata.title}
+
+In this chapter, you'll learn about the types Medusa automatically generates under the `.medusa` directory and how you should use them.
+
+## What are Automatically Generated Types?
+
+Medusa automatically generates TypeScript types for:
+
+1. Data models collected in the [Query's graph](../module-links/query/page.mdx#querying-the-graph). These types provide you with auto-completion and type checking when using Query.
+ - Generated data model types are located in the `.medusa/types/query-entry-points.d.ts` file.
+2. Modules registered in the [Medusa container](../medusa-container/page.mdx). These types provide you with auto-completion and type checking when resolving modules from the container.
+ - Generated module registration names are located in the `.medusa/types/modules-bindings.d.ts` file.
+
+
+
+---
+
+## How to Trigger Type Generation?
+
+The Medusa application generates these types automatically when you run the application with the `dev` command:
+
+```bash npm2yarn
+npm run dev
+```
+
+So, if you add a new data model or module and you don't find it in auto-completion or type checking, you can run the `dev` command to regenerate the types.
+
+---
+
+## How to Use the Generated Types?
+
+The generated types are only meant for auto-completion and type checking.
+
+For example, consider you have a Brand Module with a `Brand` data model. Due to the auto-generated types, you can do the following:
+
+
+
+
+```ts
+const { data: [brand] } = await query.graph({
+ entity: "brand",
+ fields: ["*"],
+ filters: {
+ id: "brand_123",
+ },
+})
+
+// brands has the correct type, so you can access its properties with auto-completion and type checking
+console.log(brand.name)
+```
+
+
+
+
+```ts
+const brandModuleService = req.scope.resolve("brand")
+
+// brandModuleService has the correct type, so you can access its methods with auto-completion and type checking
+const brand = await brandModuleService.retrieveBrand("brand_123")
+```
+
+
+
+
+### Don't Import the Generated Types
+
+The generated types are only meant to help you in your development process by providing auto-completion and type checking. You should not import them directly in your code.
+
+Since you don't commit the `.medusa` directory to your version control system or your production environment, importing these types may lead to build errors.
+
+Instead, if you need to use a data model's type in your customizations, you can use the [InferTypeOf](../data-models/infer-type/page.mdx) utility function, which infers the type of a data model based on its properties.
+
+For example, if you want to use the `Brand` data model's type in your customizations, you can do the following:
+
+```ts
+import { InferTypeOf } from "@medusajs/framework/types"
+import { Brand } from "../modules/brand/models/brand" // relative path to the model
+
+export type BrandType = InferTypeOf
+```
+
+You can then use the `BrandType` type in your customizations, such as in workflow inputs or service method outputs.
diff --git a/www/apps/book/app/learn/fundamentals/medusa-container/page.mdx b/www/apps/book/app/learn/fundamentals/medusa-container/page.mdx
index beaeed86ec..ce0f21d8d0 100644
--- a/www/apps/book/app/learn/fundamentals/medusa-container/page.mdx
+++ b/www/apps/book/app/learn/fundamentals/medusa-container/page.mdx
@@ -178,3 +178,13 @@ const step1 = createStep("step-1", async (_, { container }) => {
A [module](../../fundamentals/modules/page.mdx), which is a package of functionalities for a single feature or domain, has its own container, so it can't resolve resources from the Medusa container.
Learn more about the module's container in [this chapter](../../fundamentals/modules/container/page.mdx).
+
+---
+
+## Container Registration Keys Auto-Completion
+
+When you resolve a resource from the Medusa container, you can use auto-completion to find the registration key of the resource.
+
+This is possible due to Medusa's auto-generated types, which are generated in the `.medusa` directory when you run the `dev` command.
+
+Learn more in the [Auto-Generated Types](../generated-types/page.mdx) chapter.
\ No newline at end of file
diff --git a/www/apps/book/generated/edit-dates.mjs b/www/apps/book/generated/edit-dates.mjs
index 0bc9ba6a51..aa1ec31baa 100644
--- a/www/apps/book/generated/edit-dates.mjs
+++ b/www/apps/book/generated/edit-dates.mjs
@@ -12,7 +12,7 @@ export const generatedEditDates = {
"app/learn/fundamentals/admin-customizations/page.mdx": "2024-10-07T12:41:39.218Z",
"app/learn/fundamentals/workflows/workflow-timeout/page.mdx": "2025-04-24T13:15:14.472Z",
"app/learn/fundamentals/workflows/parallel-steps/page.mdx": "2025-03-24T06:53:36.918Z",
- "app/learn/fundamentals/medusa-container/page.mdx": "2024-12-09T11:02:38.225Z",
+ "app/learn/fundamentals/medusa-container/page.mdx": "2025-07-25T13:18:36.859Z",
"app/learn/fundamentals/api-routes/page.mdx": "2024-12-04T11:02:57.134Z",
"app/learn/fundamentals/modules/modules-directory-structure/page.mdx": "2024-12-09T10:32:46.839Z",
"app/learn/fundamentals/events-and-subscribers/page.mdx": "2025-05-16T13:40:16.111Z",
@@ -123,5 +123,6 @@ export const generatedEditDates = {
"app/learn/fundamentals/module-links/index/page.mdx": "2025-05-23T07:57:58.958Z",
"app/learn/fundamentals/module-links/index-module/page.mdx": "2025-06-19T16:02:05.665Z",
"app/learn/introduction/build-with-llms-ai/page.mdx": "2025-07-22T16:19:11.668Z",
- "app/learn/installation/docker/page.mdx": "2025-07-23T15:34:18.530Z"
+ "app/learn/installation/docker/page.mdx": "2025-07-23T15:34:18.530Z",
+ "app/learn/fundamentals/generated-types/page.mdx": "2025-07-25T13:17:35.319Z"
}
\ No newline at end of file
diff --git a/www/apps/book/generated/sidebar.mjs b/www/apps/book/generated/sidebar.mjs
index 1e6a0fa891..49e5f46532 100644
--- a/www/apps/book/generated/sidebar.mjs
+++ b/www/apps/book/generated/sidebar.mjs
@@ -932,6 +932,16 @@ export const generatedSidebars = [
],
"chapterTitle": "3.11. Custom CLI Scripts",
"number": "3.11."
+ },
+ {
+ "loaded": true,
+ "isPathHref": true,
+ "type": "link",
+ "path": "/learn/fundamentals/generated-types",
+ "title": "Auto-Generated Types",
+ "children": [],
+ "chapterTitle": "3.12. Auto-Generated Types",
+ "number": "3.12."
}
],
"chapterTitle": "3. Framework",
diff --git a/www/apps/book/public/llms-full.txt b/www/apps/book/public/llms-full.txt
index ee6afd2178..bd6a40b6d8 100644
--- a/www/apps/book/public/llms-full.txt
+++ b/www/apps/book/public/llms-full.txt
@@ -11132,6 +11132,85 @@ To learn more about the different concepts useful for building plugins, check ou
- [Plugins](https://docs.medusajs.com/learn/fundamentals/plugins/index.html.md)
+# Automatically Generated Types
+
+In this chapter, you'll learn about the types Medusa automatically generates under the `.medusa` directory and how you should use them.
+
+## What are Automatically Generated Types?
+
+Medusa automatically generates TypeScript types for:
+
+
+
+1. Data models collected in the [Query's graph](https://docs.medusajs.com/learn/fundamentals/module-links/query#querying-the-graph/index.html.md). These types provide you with auto-completion and type checking when using Query.
+ - Generated data model types are located in the `.medusa/types/query-entry-points.d.ts` file.
+2. Modules registered in the [Medusa container](https://docs.medusajs.com/learn/fundamentals/medusa-container/index.html.md). These types provide you with auto-completion and type checking when resolving modules from the container.
+ - Generated module registration names are located in the `.medusa/types/modules-bindings.d.ts` file.
+
+***
+
+## How to Trigger Type Generation?
+
+The Medusa application generates these types automatically when you run the application with the `dev` command:
+
+```bash npm2yarn
+npm run dev
+```
+
+So, if you add a new data model or module and you don't find it in auto-completion or type checking, you can run the `dev` command to regenerate the types.
+
+***
+
+## How to Use the Generated Types?
+
+The generated types are only meant for auto-completion and type checking.
+
+For example, consider you have a Brand Module with a `Brand` data model. Due to the auto-generated types, you can do the following:
+
+### Query
+
+```ts
+const { data: [brand] } = await query.graph({
+ entity: "brand",
+ fields: ["*"],
+ filters: {
+ id: "brand_123",
+ },
+})
+
+// brands has the correct type, so you can access its properties with auto-completion and type checking
+console.log(brand.name)
+```
+
+### Container
+
+```ts
+const brandModuleService = req.scope.resolve("brand")
+
+// brandModuleService has the correct type, so you can access its methods with auto-completion and type checking
+const brand = await brandModuleService.retrieveBrand("brand_123")
+```
+
+### Don't Import the Generated Types
+
+The generated types are only meant to help you in your development process by providing auto-completion and type checking. You should not import them directly in your code.
+
+Since you don't commit the `.medusa` directory to your version control system or your production environment, importing these types may lead to build errors.
+
+Instead, if you need to use a data model's type in your customizations, you can use the [InferTypeOf](https://docs.medusajs.com/learn/fundamentals/data-models/infer-type/index.html.md) utility function, which infers the type of a data model based on its properties.
+
+For example, if you want to use the `Brand` data model's type in your customizations, you can do the following:
+
+```ts
+import { InferTypeOf } from "@medusajs/framework/types"
+import { Brand } from "../modules/brand/models/brand" // relative path to the model
+
+export type BrandType = InferTypeOf
+```
+
+You can then use the `BrandType` type in your customizations, such as in workflow inputs or service method outputs.
+
+
# Medusa Container
In this chapter, you’ll learn about the Medusa container and how to use it.
@@ -11281,6 +11360,16 @@ A [module](https://docs.medusajs.com/learn/fundamentals/modules/index.html.md),
Learn more about the module's container in [this chapter](https://docs.medusajs.com/learn/fundamentals/modules/container/index.html.md).
+***
+
+## Container Registration Keys Auto-Completion
+
+When you resolve a resource from the Medusa container, you can use auto-completion to find the registration key of the resource.
+
+This is possible due to Medusa's auto-generated types, which are generated in the `.medusa` directory when you run the `dev` command.
+
+Learn more in the [Auto-Generated Types](https://docs.medusajs.com/learn/fundamentals/generated-types/index.html.md) chapter.
+
# Add Columns to a Link Table
diff --git a/www/apps/book/sidebar.mjs b/www/apps/book/sidebar.mjs
index 6ea4c64c55..97e9be1b34 100644
--- a/www/apps/book/sidebar.mjs
+++ b/www/apps/book/sidebar.mjs
@@ -493,6 +493,11 @@ export const sidebars = [
},
],
},
+ {
+ type: "link",
+ path: "/learn/fundamentals/generated-types",
+ title: "Auto-Generated Types",
+ },
],
},
{