diff --git a/docs/content/admin/onboarding.md b/docs/content/admin/onboarding.md
index ccfe81572d..74e52099d7 100644
--- a/docs/content/admin/onboarding.md
+++ b/docs/content/admin/onboarding.md
@@ -2287,54 +2287,37 @@ The next step is to retrieve the current step of the onboarding flow from the Me
 
 In this section, you’ll implement the `TODO`s in the `OnboardingFlow` that require communicating with the backend.
 
-There are different ways you can consume custom backend endpoints. The Medusa React library provides a utility method `createCustomAdminHooks` that allows you to create a hook similar to those available by default in the library. You can then utilize these hooks to send requests to custom backend endpoints.
+There are different ways you can consume custom backend endpoints. The Medusa React library provides utility methods that allow you to create hooks similar to those available by default in the library. You can then utilize these hooks to send requests to custom backend endpoints.
 
-Create the file `src/admin/components/shared/hooks.tsx` that exports custom hooks for the custom endpoints you created in the previous step:
-
-```tsx title=src/admin/components/shared/hooks.tsx
-import { createCustomAdminHooks } from "medusa-react"
-
-const {
-  useAdminEntity: useAdminOnboardingState,
-  useAdminUpdateMutation: useAdminUpdateOnboardingStateMutation,
-} = createCustomAdminHooks("onboarding", "onboarding_state")
-
-export { 
-  useAdminOnboardingState,
-  useAdminUpdateOnboardingStateMutation,
-}
-```
-
-You can now use `useAdminOnboardingState` to retrieve the onboarding state from the backend, and `useAdminUpdateOnboardingStateMutation` to update the onboarding state in the backend.
-
-Learn more about Medusa React in [this documentation](../medusa-react/overview.md).
-
-Then, add the following imports at the top of `src/admin/widgets/onboarding-flow/onboarding-flow.tsx`:
+Add the following imports at the top of `src/admin/widgets/onboarding-flow/onboarding-flow.tsx`:
 
 ```tsx title=src/admin/widgets/onboarding-flow/onboarding-flow.tsx
 import {
-  useAdminOnboardingState,
-  useAdminUpdateOnboardingStateMutation,
-} from "../../components/shared/hooks"
+  useAdminCustomPost,
+  useAdminCustomQuery,
+} from "medusa-react"
 ```
 
 Next, add the following at the top of the `OnboardingFlow` component:
 
 ```tsx title=src/admin/widgets/onboarding-flow/onboarding-flow.tsx
 const OnboardingFlow = (props: any) => {
-  const { 
-    data,
-    isLoading,
-  } = useAdminOnboardingState<OnboardingStateRes>("")
-  const { mutate } = useAdminUpdateOnboardingStateMutation<
+  const QUERY_KEY = ["onboarding_state"]
+  const { data, isLoading } = useAdminCustomQuery<
+    undefined,
+    OnboardingStateRes
+  >("/onboarding", QUERY_KEY)
+  const { mutate } = useAdminCustomPost<
     AdminOnboardingUpdateStateReq,
     OnboardingStateRes
-  >("")
+  >("/onboarding", QUERY_KEY)
 
   // ...
 }
 ```
 
+Learn more about the available custom hooks such as `useAdminCustomPost` and `useAdminCustomQuery` in the [Medusa React documentation](../medusa-react/overview.mdx#custom-hooks).
+
 `data` now holds the current onboarding state from the backend, and `mutate` can be used to update the onboarding state in the backend.
 
 After that, replace the declarations within `OnboardingFlow` that had a `TODO` comment with the following:
diff --git a/docs/content/admin/routes.md b/docs/content/admin/routes.md
index b0fd396e56..0479d4fed8 100644
--- a/docs/content/admin/routes.md
+++ b/docs/content/admin/routes.md
@@ -291,11 +291,11 @@ export default CustomPage
 
 ## Querying and Mutating Data
 
-You might need to interact with the Medusa backend from your admin route. To do so, you can utilize the [Medusa React package](../medusa-react/overview.md). It contains a collection of queries and mutation built on `@tanstack/react-query` that lets you interact with the Medusa backend.
+You might need to interact with the Medusa backend from your admin route. To do so, you can utilize the [Medusa React package](../medusa-react/overview.mdx). It contains a collection of queries and mutation built on `@tanstack/react-query` that lets you interact with the Medusa backend.
 
 :::note
 
-Make sure to also install the Medusa React package first if you’re intending to use it, as explained in the [Medusa React guide](../medusa-react/overview.md).
+Make sure to also install the Medusa React package first if you’re intending to use it, as explained in the [Medusa React guide](../medusa-react/overview.mdx).
 
 :::
 
@@ -316,7 +316,7 @@ const CustomPage = () => {
 export default CustomPage
 ```
 
-You can also use `medusa-react` to interact with custom endpoints using the [createCustomAdminHooks utility function](../medusa-react/overview.md#custom-hooks).
+You can also use `medusa-react` to interact with custom endpoints using the [createCustomAdminHooks utility function](../medusa-react/overview.mdx#custom-hooks).
 
 ---
 
diff --git a/docs/content/admin/widgets.md b/docs/content/admin/widgets.md
index 53371d99d2..2b56108790 100644
--- a/docs/content/admin/widgets.md
+++ b/docs/content/admin/widgets.md
@@ -1230,7 +1230,7 @@ You will most likely need to interact with the Medusa backend  from your Widgets
 
 :::note
 
-Make sure to also install the Medusa React package first if you’re intending to use it, as explained in the [Medusa React guide](../medusa-react/overview.md).
+Make sure to also install the Medusa React package first if you’re intending to use it, as explained in the [Medusa React guide](../medusa-react/overview.mdx).
 
 :::
 
@@ -1273,7 +1273,7 @@ export const config: WidgetConfig = {
 export default ProductWidget
 ```
 
-You can also use `medusa-react` to interact with custom endpoints using the [createCustomAdminHooks utility function](../medusa-react/overview.md#custom-hooks).
+You can also use `medusa-react` to interact with custom endpoints using the [createCustomAdminHooks utility function](../medusa-react/overview.mdx#custom-hooks).
 
 ---
 
diff --git a/docs/content/development/publishable-api-keys/admin/manage-publishable-api-keys.mdx b/docs/content/development/publishable-api-keys/admin/manage-publishable-api-keys.mdx
index 8eed22939c..979231ab81 100644
--- a/docs/content/development/publishable-api-keys/admin/manage-publishable-api-keys.mdx
+++ b/docs/content/development/publishable-api-keys/admin/manage-publishable-api-keys.mdx
@@ -49,7 +49,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/medusa-react/overview.md b/docs/content/medusa-react/overview.mdx
similarity index 68%
rename from docs/content/medusa-react/overview.md
rename to docs/content/medusa-react/overview.mdx
index 8ffc93cd49..2166fb7873 100644
--- a/docs/content/medusa-react/overview.md
+++ b/docs/content/medusa-react/overview.mdx
@@ -2,6 +2,9 @@
 description: 'Learn how to install Medusa React in a React storefront. Medusa React is a React library that provides a set of utilities and hooks for interactive with the Medusa backend.'
 ---
 
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
 # Medusa React
 
 [Medusa React](https://www.npmjs.com/package/medusa-react) is a React library that provides a set of utilities and hooks for interacting seamlessly with the Medusa backend. It can be used to build custom React-based storefronts or admin dashboards.
@@ -200,92 +203,269 @@ npm install medusa-react@beta @medusajs/medusa@beta
 
 :::
 
-Medusa React provides a utility function `createCustomAdminHooks` that allows developers to consume their admin custom endpoints using the same Medusa React methods and conventions. It returns custom mutation and query hooks that you can use to retrieve and manipulate data using your custom endpoints. This utility function is useful when customizing the admin with widgets.
+Medusa React provides three utility hooks that allows developers to consume their admin custom endpoints using the same Medusa React methods and conventions.
+
+#### useAdminCustomQuery
+
+The `useAdminCustomQuery` utility hook can be used to send a `GET` request to a custom endpoint in your Medusa backend and retrieve data. It's a generic function, so you can pass a type for the request and the response if you're using TypeScript in your development. The first type parameter is the type of the request body, and the second type parameter is the type of the expected response body:
 
 ```ts
-import { createCustomAdminHooks } from "medusa-react"
-
-const {
-  useAdminEntity,
-  useAdminEntities,
-  useAdminCreateMutation,
-  useAdminUpdateMutation,
-  useAdminDeleteMutation,
-} = createCustomAdminHooks(
-  `/vendors`, 
-  "vendors",
-  { product: true }
-)
+useAdminCustomQuery<RequestType, ResponseType>
 ```
 
-It accepts the following parameters:
+The hook accepts the following parameters:
 
-1. `path`: (required) the first parameter is a string that indicates the base path to the custom endpoint. For example, if you have custom endpoints that begin with `/admin/vendors`, the value of this parameter would be `vendors`. The `/admin` prefix will be added automatically.
-2. `queryKey`: (required) the second parameter is a string used to generate query keys for all `GET` hooks, which is used by Tanstack Query for caching. When a mutation related to this same key succeeds, the key will be automatically invalidated.
-3. `relatedDomains`: (optional) the third parameter is an object that can be used to specify domains related to this custom hook. This will ensure that Tanstack Query invalides the keys for those domains when your custom mutations succeed. For example, if your custom endpoint is related to products, you can pass `{ product: true }` as the value of this parameter. Then, when you use your custom mutation and it succeeds, the product's key `adminProductKeys.all` will be invalidated automatically, and all products will be re-fetched.
+1. `path`: (required) the first parameter is a string indicating the path of your endpoint. For example, if you have custom endpoints that begin with `/admin/vendors`, the value of this parameter would be `vendors`. The `/admin` prefix will be added automatically.
+2. `queryKey`: (required) the second parameter is a string used to generate query keys, which are used by Tanstack Query for caching. When a mutation related to this same key succeeds, the key will be automatically invalidated.
+3. `query`: (optional) the third parameter is an object that can be used to pass query parameters to the endpoint. For example, if you want to pass an `expand` query parameter you can pass it within this object. Each query parameter's name is a key in the object. There are no limitations on what the type of the value can be, so you can pass an array or simply a string as a value.
+4. `options`: (optional) the fourth parameter is an object of [TanStack Query options](https://tanstack.com/query/v4/docs/react/reference/useQuery).
 
-:::note
+The request returns an object containing keys like `data` which is an object that includes the data returned in the response, and `isLoading` which is a boolean value indicating whether the request is still in progress. You can learn more about the returned object's properties in [TanStack Query's documentation](https://tanstack.com/query/v4/docs/react/reference/useQuery).
 
-While the mechanism implemented using the `relatedDomains` parameter may seem a bit excessive, Tanstack Query is smart enough to only re-fetch the queries that are currently active. So, it won't result in all queries being re-fetched simultaneously.
+For example:
 
-:::
+<Tabs groupId="admin-custom-query" isCodeTabs={true}>
+<TabItem value="post-page" label="src/admin/routes/blog/posts/[id]/page.tsx" default>
 
-The function returns an object containing the following hooks:
+```tsx
+import { useAdminCustomQuery } from "medusa-react"
+import { useParams } from "react-router-dom"
 
-- `useAdminEntity`: is a query hook that allows retrieving a single entry using your custom endpoint. For example, if you have the `GET` endpoint `/admin/vendors/:id`, where `:id` is the ID of a vendor, you can use this hook to call that endpoint and retrieve a vendor by its ID.
-- `useAdminEntities`: is a query hook that allows retrieving a list of entries using your custom endpoint. For example, if you have the `GET` endpoint `/admin/vendors`, you can use this hook to call that endpoint and retrieve the list of vendors.
-- `useAdminCreateMutation`: is a mutation hook that allows creating an entry using your custom endpoint. For example, if you have the `POST` endpoint `/admin/vendors`, you can use this hook to call that endpoint and create a vendor.
-- `useAdminUpdateMutation`: is a mutation hook that allows updating an entry using your custom endpoint. For example, if you have the `POST` endpoint `/admin/vendors/:id`, you can use this hook to call that endpoint and update a vendor.
-- `useAdminDeleteMutation`: is a mutation hook that allows deleting an entry using your custom endpoint. For example, if you have the `DELETE` endpoint `/admin/vendors/:id`, you can use this hook to call that endpoint and delete a vendor.
+type BlogPost = {
+  title: string,
+  content: string,
+  author_id: string,
+}
 
-Each of these hooks are generic, allowing you to set the types for the functions and receive IntelliSense for the query parameters, the payload, and return data. The first generic type accepted would be the type of the request, and the second type accepted would be the type of the response.
+// Single post
+type AdminBlogPostQuery = {
+  expand?: string,
+  fields?: string
+}
 
-An example of using `createCustomAdminHooks`:
+type AdminBlogPostRes = {
+  post: BlogPost,
+}
+
+const BlogPost = () => {
+  const { id } = useParams() 
+
+  const { data: { post }, isLoading } = useAdminCustomQuery<
+    AdminBlogPostQuery,
+    AdminBlogPostRes
+  >(
+    `/blog/posts/${id}`,  // path
+    ["blog-post", id], // queryKey
+    {
+      expand: "author", // query
+    }
+   )
+
+  return (
+    <>
+      {isLoading && <span>Loading...</span>}
+      {post && <span>{post.title}</span>}
+    </>
+  )
+}
+
+export default BlogPost
+```
+
+</TabItem>
+<TabItem value="posts-page" label="src/admin/routes/blog/author/[id]/posts/page.tsx">
+
+```tsx
+import { useAdminCustomQuery } from "medusa-react"
+import { useParams } from "react-router-dom"
+
+type BlogPost = {
+  title: string,
+  content: string,
+  author_id: string,
+}
+
+type AdminBlogPostsRes = {
+  posts: BlogPost[],
+  count: number
+}
+
+type AdminBlogPostsQuery = {
+  author_id: string,
+  created_at?: string,
+  expand?: string,
+  fields?: string
+}
+
+const AuthorsBlogPosts = () => {
+  const { id } = useParams() 
+
+  const { data: { posts }, isLoading } = useAdminCustomQuery<
+    AdminBlogPostsQuery, AdminBlogPostsRes
+  >(
+    `/blog/posts`,  // path
+    ["blog-posts", "list", id], // queryKey
+    {
+      expand: "author", // query
+      author_id: "auth_123",
+    }
+   )
+
+   return (
+     <>
+       {isLoading && <span>Loading...</span>}
+       {posts && <span>{posts.map((post, index) => (
+        <span key={index}>{post.title}</span>
+       ))}</span>}
+     </>
+   )
+}
+
+export default AuthorsBlogPosts
+```
+
+</TabItem>
+</Tabs>
+
+#### useAdminCustomPost
+
+The `useAdminCustomPost` utility hook can be used to send a `POST` request to a custom endpoint in your Medusa backend. It's a generic function, so you can pass a type for the request and the response if you're using TypeScript in your development. The first type parameter is the type of the request body, and the second type parameter is the type of the expected response body:
 
 ```ts
-import { createCustomAdminHooks } from "medusa-react"
+useAdminCustomPost<RequestType, ResponseType>
+```
 
-type PostVendorsReq = {
-  name: string
+The hook accepts the following parameters:
+
+1. `path`: (required) the first parameter is a string indicating the path of your endpoint. For example, if you have custom endpoints that begin with `/admin/vendors`, the value of this parameter would be `vendors`. The `/admin` prefix will be added automatically.
+2. `queryKey`: (required) the second parameter is a string used to generate query keys, which are used by Tanstack Query for caching. When the mutation succeeds, the key will be automatically invalidated.
+3. `relatedDomains`: (optional) the third parameter is an object that can be used to specify domains related to this custom hook. This will ensure that Tanstack Query invalides the keys for those domains when your custom mutations succeed. For example, if your custom endpoint is related to products, you can pass `["products"]` as the value of this parameter. Then, when you use your custom mutation and it succeeds, the product's key `adminProductKeys.all` will be invalidated automatically, and all products will be re-fetched.
+4. `options`: (optional) the fourth parameter is an object of [Mutation options](https://tanstack.com/query/v4/docs/react/reference/useMutation).
+
+The request returns an object containing keys like `mutation` which is a function that can be used to send the `POST` request at a later point. You can learn more about the returned object's properties in [TanStack Query's documentation](https://tanstack.com/query/v4/docs/react/reference/useMutation).
+
+For example:
+
+```tsx title=src/admin/routes/blog/posts/page.tsx
+import { useAdminCustomPost } from "medusa-react"
+import { useNavigate } from "react-router-dom"
+
+type BlogPost = {
+  id: string
+  title: string,
+  content: string,
+  author_id: string,
 }
 
-type PostVendorRes = {
-  vendor: Vendor // assuming there's a type vendor
+type AdminBlogPostReq = {
+  title: string,
+  content: string,
+  author_id: string,
 }
 
-const MyWidget = () => {
-  const { 
-    useAdminCreateMutation: useCreateVendor,
-  } = createCustomAdminHooks(
-    `/vendors`, 
-    "vendors",
-    { product: true }
-  )
+type AdminBlogPostRes = {
+  post: BlogPost,
+}
 
-  const { mutate } = useCreateVendor<
-    PostVendorsReq, 
-    PostVendorRes
-  >()
+const CreateBlogPost = () => {
+  const navigate = useNavigate() 
 
-  // ...
+  const { mutate, isLoading } = useAdminCustomPost<
+    AdminBlogPostReq,
+    AdminBlogPostRes
+  >(
+    `/blog/posts`,
+    ["blog-posts"],
+    {
+      product: true,
+    }
+   )
 
-  const handleCreate = () => {
-    mutate({
-      name: "Vendor 1",
-    }, {
-      onSuccess({ vendor }) {
-        console.log(vendor)
+  const handleCreate = (args: AdminBlogPostReq) => {
+    return mutate(args, {
+      onSuccess: (data) => {
+        navigate(`blog/posts/${data.post.id}`)
       },
     })
   }
 
-  // ...
+  // TODO replace with actual form
+  return (
+    <button
+      onClick={() => handleCreate({
+        title: "First Blog Post",
+        content: "Blog Content",
+        author_id: "auth_123",
+      })}>
+        Create
+    </button>
+  )
 }
+
+export default CreateBlogPost
 ```
 
-In the example above, you use `createCustomAdminHooks` to create the custom hook `useAdminCreateMutation`, renamed to `useCreateVendor`. You then use `useCreateVendor` to initialize the `mutate` function. You set the generic types of useCreateVendor to the types `PostVendorsReq` and `PostVendorRes`, which are assumed to be  the types of the create endpoint's request and response respectively.
+#### useAdminCustomDelete
 
-Later in your code, you can use the `mutate` function to send a request to your endpoint and create a new vendor. The `mutate` function accepts the request's body parameters as an object. You can use the `onSuccess` function, which can be defined in the second parameter object of the `mutate` function, to get access to the response received.
+The `useAdminCustomDelete` utility hook can be used to send a `DELETE` request to a custom endpoint in your Medusa backend. It's a generic function, so you can pass a type for the request body if you're using TypeScript in your development:
+
+```ts
+useAdminCustomPost<RequestType, ResponseType>
+```
+
+The hook accepts the following parameters:
+
+1. `path`: (required) the first parameter is a string indicating the path of your endpoint. For example, if you have custom endpoints that begin with `/admin/vendors`, the value of this parameter would be `vendors`. The `/admin` prefix will be added automatically.
+2. `queryKey`: (required) the second parameter is a string used to generate query keys, which are used by Tanstack Query for caching. When the mutation succeeds, the key will be automatically invalidated.
+3. `relatedDomains`: (optional) the third parameter is an object that can be used to specify domains related to this custom hook. This will ensure that Tanstack Query invalides the keys for those domains when your custom mutations succeed. For example, if your custom endpoint is related to products, you can pass `["products"]` as the value of this parameter. Then, when you use your custom mutation and it succeeds, the product's key `adminProductKeys.all` will be invalidated automatically, and all products will be re-fetched.
+4. `options`: (optional) the fourth parameter is an object of [Mutation options](https://tanstack.com/query/v4/docs/react/reference/useMutation).
+
+The request returns an object containing keys like `mutation` which is a function that can be used to send the `DELETE` request at a later point. You can learn more about the returned object's properties in [TanStack Query's documentation](https://tanstack.com/query/v4/docs/react/reference/useMutation).
+
+For example:
+
+```tsx title=src/admin/routes/blog/posts/[id]/page.tsx
+import { useAdminCustomDelete } from "medusa-react"
+import { useNavigate, useParams } from "react-router-dom"
+
+type AdminBlogPostDeleteRes = {
+  id: string,
+  type: string
+}
+
+const BlogPost = () => {
+  const { id } = useParams()
+  const navigate = useNavigate() 
+
+  const { mutate, isLoading } = useAdminCustomDelete<
+    AdminBlogPostDeleteRes
+  >(
+    `/blog/posts/${id}`,
+    ["blog-posts"],
+    {
+      product: true,
+    }
+   )
+
+  const handleDelete = () => {
+    return mutate(undefined, {
+      onSuccess: () => {
+        navigate("..")
+      },
+    })
+  }
+
+  // TODO replace with actual form
+  return (
+    <button
+      onClick={() => handleDelete()}>
+        Delete
+    </button>
+  )
+}
+
+export default BlogPost
+```
 
 ---
 
diff --git a/docs/content/modules/carts-and-checkout/storefront/implement-cart.mdx b/docs/content/modules/carts-and-checkout/storefront/implement-cart.mdx
index 7662a8e4a2..05831e58f5 100644
--- a/docs/content/modules/carts-and-checkout/storefront/implement-cart.mdx
+++ b/docs/content/modules/carts-and-checkout/storefront/implement-cart.mdx
@@ -42,9 +42,9 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
-It's also assumed you already have [used CartProvider higher in your component tree](../../../medusa-react/overview.md#cartprovider).
+It's also assumed you already have [used CartProvider higher in your component tree](../../../medusa-react/overview.mdx#cartprovider).
 
 ---
 
diff --git a/docs/content/modules/carts-and-checkout/storefront/implement-checkout-flow.mdx b/docs/content/modules/carts-and-checkout/storefront/implement-checkout-flow.mdx
index ad64283863..46ecb22f7d 100644
--- a/docs/content/modules/carts-and-checkout/storefront/implement-checkout-flow.mdx
+++ b/docs/content/modules/carts-and-checkout/storefront/implement-checkout-flow.mdx
@@ -42,9 +42,9 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
-It's also assumed you already have [used CartProvider higher in your component tree](../../../medusa-react/overview.md#cartprovider).
+It's also assumed you already have [used CartProvider higher in your component tree](../../../medusa-react/overview.mdx#cartprovider).
 
 ### Previous Steps
 
diff --git a/docs/content/modules/customers/admin/manage-customer-groups.mdx b/docs/content/modules/customers/admin/manage-customer-groups.mdx
index 558c295a70..8c6bc4a414 100644
--- a/docs/content/modules/customers/admin/manage-customer-groups.mdx
+++ b/docs/content/modules/customers/admin/manage-customer-groups.mdx
@@ -36,7 +36,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/modules/customers/admin/manage-customers.mdx b/docs/content/modules/customers/admin/manage-customers.mdx
index 2511312a62..f56a4eccf0 100644
--- a/docs/content/modules/customers/admin/manage-customers.mdx
+++ b/docs/content/modules/customers/admin/manage-customers.mdx
@@ -40,7 +40,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/modules/customers/storefront/implement-customer-profiles.mdx b/docs/content/modules/customers/storefront/implement-customer-profiles.mdx
index 1c2db7445a..a45a184a10 100644
--- a/docs/content/modules/customers/storefront/implement-customer-profiles.mdx
+++ b/docs/content/modules/customers/storefront/implement-customer-profiles.mdx
@@ -50,7 +50,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ---
 
diff --git a/docs/content/modules/discounts/admin/manage-discounts.mdx b/docs/content/modules/discounts/admin/manage-discounts.mdx
index f3d6bf736b..bac74a056f 100644
--- a/docs/content/modules/discounts/admin/manage-discounts.mdx
+++ b/docs/content/modules/discounts/admin/manage-discounts.mdx
@@ -52,7 +52,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/modules/discounts/storefront/use-discounts-in-checkout.mdx b/docs/content/modules/discounts/storefront/use-discounts-in-checkout.mdx
index b0762fca0a..5b9182953f 100644
--- a/docs/content/modules/discounts/storefront/use-discounts-in-checkout.mdx
+++ b/docs/content/modules/discounts/storefront/use-discounts-in-checkout.mdx
@@ -46,9 +46,9 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
-It's also assumed you already have [used CartProvider higher in your component tree](../../../medusa-react/overview.md#cartprovider).
+It's also assumed you already have [used CartProvider higher in your component tree](../../../medusa-react/overview.mdx#cartprovider).
 
 ### Previous Steps
 
diff --git a/docs/content/modules/gift-cards/admin/manage-gift-cards.mdx b/docs/content/modules/gift-cards/admin/manage-gift-cards.mdx
index 95c50011c1..0172c854bb 100644
--- a/docs/content/modules/gift-cards/admin/manage-gift-cards.mdx
+++ b/docs/content/modules/gift-cards/admin/manage-gift-cards.mdx
@@ -45,7 +45,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/modules/gift-cards/storefront/use-gift-cards.mdx b/docs/content/modules/gift-cards/storefront/use-gift-cards.mdx
index 650f08215c..e7a046f7dd 100644
--- a/docs/content/modules/gift-cards/storefront/use-gift-cards.mdx
+++ b/docs/content/modules/gift-cards/storefront/use-gift-cards.mdx
@@ -42,9 +42,9 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
-For requests that use the cart, it's also assumed you already have [used CartProvider higher in your component tree](../../../medusa-react/overview.md#cartprovider).
+For requests that use the cart, it's also assumed you already have [used CartProvider higher in your component tree](../../../medusa-react/overview.mdx#cartprovider).
 
 ### Previous Steps
 
diff --git a/docs/content/modules/multiwarehouse/admin/manage-inventory-items.mdx b/docs/content/modules/multiwarehouse/admin/manage-inventory-items.mdx
index b96e2a8a2d..b828eda741 100644
--- a/docs/content/modules/multiwarehouse/admin/manage-inventory-items.mdx
+++ b/docs/content/modules/multiwarehouse/admin/manage-inventory-items.mdx
@@ -45,7 +45,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/modules/multiwarehouse/admin/manage-item-allocations-in-orders.mdx b/docs/content/modules/multiwarehouse/admin/manage-item-allocations-in-orders.mdx
index d44ad1e3f7..7f385663c7 100644
--- a/docs/content/modules/multiwarehouse/admin/manage-item-allocations-in-orders.mdx
+++ b/docs/content/modules/multiwarehouse/admin/manage-item-allocations-in-orders.mdx
@@ -56,7 +56,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/modules/multiwarehouse/admin/manage-reservations.mdx b/docs/content/modules/multiwarehouse/admin/manage-reservations.mdx
index ff9d0470a4..5f7bed8372 100644
--- a/docs/content/modules/multiwarehouse/admin/manage-reservations.mdx
+++ b/docs/content/modules/multiwarehouse/admin/manage-reservations.mdx
@@ -57,7 +57,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/modules/multiwarehouse/admin/manage-stock-locations.mdx b/docs/content/modules/multiwarehouse/admin/manage-stock-locations.mdx
index 13bdcf2dd9..d54234ff85 100644
--- a/docs/content/modules/multiwarehouse/admin/manage-stock-locations.mdx
+++ b/docs/content/modules/multiwarehouse/admin/manage-stock-locations.mdx
@@ -47,7 +47,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/modules/orders/admin/edit-order.mdx b/docs/content/modules/orders/admin/edit-order.mdx
index 717f4125c3..8db90d6458 100644
--- a/docs/content/modules/orders/admin/edit-order.mdx
+++ b/docs/content/modules/orders/admin/edit-order.mdx
@@ -62,7 +62,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/modules/orders/admin/manage-claims.mdx b/docs/content/modules/orders/admin/manage-claims.mdx
index e1b4854a18..576b149f07 100644
--- a/docs/content/modules/orders/admin/manage-claims.mdx
+++ b/docs/content/modules/orders/admin/manage-claims.mdx
@@ -46,7 +46,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/modules/orders/admin/manage-draft-orders.mdx b/docs/content/modules/orders/admin/manage-draft-orders.mdx
index 4a8de2f37e..fc7a67aecb 100644
--- a/docs/content/modules/orders/admin/manage-draft-orders.mdx
+++ b/docs/content/modules/orders/admin/manage-draft-orders.mdx
@@ -40,7 +40,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/modules/orders/admin/manage-orders.mdx b/docs/content/modules/orders/admin/manage-orders.mdx
index 11ae2ae36b..f6c9d33cc1 100644
--- a/docs/content/modules/orders/admin/manage-orders.mdx
+++ b/docs/content/modules/orders/admin/manage-orders.mdx
@@ -48,7 +48,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/modules/orders/admin/manage-returns.mdx b/docs/content/modules/orders/admin/manage-returns.mdx
index e2c54050e5..5e7327664d 100644
--- a/docs/content/modules/orders/admin/manage-returns.mdx
+++ b/docs/content/modules/orders/admin/manage-returns.mdx
@@ -41,7 +41,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/modules/orders/admin/manage-swaps.mdx b/docs/content/modules/orders/admin/manage-swaps.mdx
index 4de5724c3e..964a2eb54c 100644
--- a/docs/content/modules/orders/admin/manage-swaps.mdx
+++ b/docs/content/modules/orders/admin/manage-swaps.mdx
@@ -47,7 +47,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/modules/orders/storefront/create-return.mdx b/docs/content/modules/orders/storefront/create-return.mdx
index b385a7103f..80e5b0daee 100644
--- a/docs/content/modules/orders/storefront/create-return.mdx
+++ b/docs/content/modules/orders/storefront/create-return.mdx
@@ -47,7 +47,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ---
 
diff --git a/docs/content/modules/orders/storefront/create-swap.mdx b/docs/content/modules/orders/storefront/create-swap.mdx
index 0f99676bfb..ea88c4a0cc 100644
--- a/docs/content/modules/orders/storefront/create-swap.mdx
+++ b/docs/content/modules/orders/storefront/create-swap.mdx
@@ -42,7 +42,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ---
 
diff --git a/docs/content/modules/orders/storefront/handle-order-edits.mdx b/docs/content/modules/orders/storefront/handle-order-edits.mdx
index 237b210d39..0e323103ed 100644
--- a/docs/content/modules/orders/storefront/handle-order-edits.mdx
+++ b/docs/content/modules/orders/storefront/handle-order-edits.mdx
@@ -60,7 +60,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Previous Steps
 
diff --git a/docs/content/modules/orders/storefront/implement-claim-order.mdx b/docs/content/modules/orders/storefront/implement-claim-order.mdx
index b02d94434f..632ff90580 100644
--- a/docs/content/modules/orders/storefront/implement-claim-order.mdx
+++ b/docs/content/modules/orders/storefront/implement-claim-order.mdx
@@ -57,7 +57,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Handle Order Claim Request Event
 
diff --git a/docs/content/modules/orders/storefront/retrieve-order-details.mdx b/docs/content/modules/orders/storefront/retrieve-order-details.mdx
index 1b48afc65d..155f0a28bb 100644
--- a/docs/content/modules/orders/storefront/retrieve-order-details.mdx
+++ b/docs/content/modules/orders/storefront/retrieve-order-details.mdx
@@ -28,7 +28,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ---
 
diff --git a/docs/content/modules/price-lists/admin/import-prices.mdx b/docs/content/modules/price-lists/admin/import-prices.mdx
index c9f975a5a4..39b6598c5d 100644
--- a/docs/content/modules/price-lists/admin/import-prices.mdx
+++ b/docs/content/modules/price-lists/admin/import-prices.mdx
@@ -49,7 +49,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/modules/price-lists/admin/manage-price-lists.mdx b/docs/content/modules/price-lists/admin/manage-price-lists.mdx
index 48f4d4cf9b..1d5d918417 100644
--- a/docs/content/modules/price-lists/admin/manage-price-lists.mdx
+++ b/docs/content/modules/price-lists/admin/manage-price-lists.mdx
@@ -32,7 +32,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/modules/products/admin/import-products.mdx b/docs/content/modules/products/admin/import-products.mdx
index c7a493df2c..e61c68378c 100644
--- a/docs/content/modules/products/admin/import-products.mdx
+++ b/docs/content/modules/products/admin/import-products.mdx
@@ -49,7 +49,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/modules/products/admin/manage-categories.mdx b/docs/content/modules/products/admin/manage-categories.mdx
index 22f60af2c6..c51eaf3645 100644
--- a/docs/content/modules/products/admin/manage-categories.mdx
+++ b/docs/content/modules/products/admin/manage-categories.mdx
@@ -39,7 +39,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/modules/products/admin/manage-products.mdx b/docs/content/modules/products/admin/manage-products.mdx
index 5984146e25..a856577650 100644
--- a/docs/content/modules/products/admin/manage-products.mdx
+++ b/docs/content/modules/products/admin/manage-products.mdx
@@ -40,7 +40,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/modules/products/storefront/show-products.mdx b/docs/content/modules/products/storefront/show-products.mdx
index 40114c3aa1..404618590f 100644
--- a/docs/content/modules/products/storefront/show-products.mdx
+++ b/docs/content/modules/products/storefront/show-products.mdx
@@ -44,7 +44,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### @medusajs/product Module
 
diff --git a/docs/content/modules/products/storefront/use-categories.mdx b/docs/content/modules/products/storefront/use-categories.mdx
index 5e1b7ae59f..2d87732d28 100644
--- a/docs/content/modules/products/storefront/use-categories.mdx
+++ b/docs/content/modules/products/storefront/use-categories.mdx
@@ -41,7 +41,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### @medusajs/product Module
 
diff --git a/docs/content/modules/regions-and-currencies/admin/manage-currencies.mdx b/docs/content/modules/regions-and-currencies/admin/manage-currencies.mdx
index a436e2678b..2a5714ddde 100644
--- a/docs/content/modules/regions-and-currencies/admin/manage-currencies.mdx
+++ b/docs/content/modules/regions-and-currencies/admin/manage-currencies.mdx
@@ -48,7 +48,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/modules/regions-and-currencies/admin/manage-regions.mdx b/docs/content/modules/regions-and-currencies/admin/manage-regions.mdx
index e13c031572..3e75faa8a8 100644
--- a/docs/content/modules/regions-and-currencies/admin/manage-regions.mdx
+++ b/docs/content/modules/regions-and-currencies/admin/manage-regions.mdx
@@ -48,7 +48,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/modules/regions-and-currencies/storefront/use-regions.mdx b/docs/content/modules/regions-and-currencies/storefront/use-regions.mdx
index 7105f69540..416200bb96 100644
--- a/docs/content/modules/regions-and-currencies/storefront/use-regions.mdx
+++ b/docs/content/modules/regions-and-currencies/storefront/use-regions.mdx
@@ -42,9 +42,9 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
-For requests that use the cart, it's also assumed you already have [used CartProvider higher in your component tree](../../../medusa-react/overview.md#cartprovider).
+For requests that use the cart, it's also assumed you already have [used CartProvider higher in your component tree](../../../medusa-react/overview.mdx#cartprovider).
 
 ---
 
diff --git a/docs/content/modules/sales-channels/admin/manage.mdx b/docs/content/modules/sales-channels/admin/manage.mdx
index 394e76278b..3743bdd68b 100644
--- a/docs/content/modules/sales-channels/admin/manage.mdx
+++ b/docs/content/modules/sales-channels/admin/manage.mdx
@@ -40,7 +40,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/modules/sales-channels/storefront/use-sales-channels.mdx b/docs/content/modules/sales-channels/storefront/use-sales-channels.mdx
index 40c0d3269c..21671ff0a2 100644
--- a/docs/content/modules/sales-channels/storefront/use-sales-channels.mdx
+++ b/docs/content/modules/sales-channels/storefront/use-sales-channels.mdx
@@ -45,9 +45,9 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
-For requests that use the cart, it's also assumed you already have [used CartProvider higher in your component tree](../../../medusa-react/overview.md#cartprovider).
+For requests that use the cart, it's also assumed you already have [used CartProvider higher in your component tree](../../../medusa-react/overview.mdx#cartprovider).
 
 ---
 
diff --git a/docs/content/modules/taxes/admin/manage-tax-rates.mdx b/docs/content/modules/taxes/admin/manage-tax-rates.mdx
index 95cd52d764..807f447faf 100644
--- a/docs/content/modules/taxes/admin/manage-tax-rates.mdx
+++ b/docs/content/modules/taxes/admin/manage-tax-rates.mdx
@@ -39,7 +39,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/modules/taxes/admin/manage-tax-settings.mdx b/docs/content/modules/taxes/admin/manage-tax-settings.mdx
index 281e1ba3c1..4567fa5413 100644
--- a/docs/content/modules/taxes/admin/manage-tax-settings.mdx
+++ b/docs/content/modules/taxes/admin/manage-tax-settings.mdx
@@ -40,7 +40,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/modules/users/admin/manage-invites.mdx b/docs/content/modules/users/admin/manage-invites.mdx
index 745d7f504c..73abe311ca 100644
--- a/docs/content/modules/users/admin/manage-invites.mdx
+++ b/docs/content/modules/users/admin/manage-invites.mdx
@@ -42,7 +42,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/modules/users/admin/manage-profile.mdx b/docs/content/modules/users/admin/manage-profile.mdx
index eebe6074ec..c56b5e9921 100644
--- a/docs/content/modules/users/admin/manage-profile.mdx
+++ b/docs/content/modules/users/admin/manage-profile.mdx
@@ -38,7 +38,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/modules/users/admin/manage-users.mdx b/docs/content/modules/users/admin/manage-users.mdx
index 19dfb3c0f3..bc8fc6956e 100644
--- a/docs/content/modules/users/admin/manage-users.mdx
+++ b/docs/content/modules/users/admin/manage-users.mdx
@@ -41,7 +41,7 @@ If you follow the JS Client code blocks, it’s assumed you already have [Medusa
 
 This guide also includes code snippets to send requests to your Medusa backend using Medusa React, among other methods.
 
-If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.md) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.md#usage).
+If you follow the Medusa React code blocks, it's assumed you already have [Medusa React installed](../../../medusa-react/overview.mdx) and have [used MedusaProvider higher in your component tree](../../../medusa-react/overview.mdx#usage).
 
 ### Authenticated Admin User
 
diff --git a/docs/content/storefront/roadmap.mdx b/docs/content/storefront/roadmap.mdx
index c73d7e82df..da35d6fdf6 100644
--- a/docs/content/storefront/roadmap.mdx
+++ b/docs/content/storefront/roadmap.mdx
@@ -22,7 +22,7 @@ This guide provides a roadmap that can guide you into how you can build your own
 
 The storefront connects to the backend to retrieve and process data. You can use different tools or libraries when connecting your storefront to the backend.
 
-- **For React-based storefronts:** you can use [Medusa React](../medusa-react/overview.md). It provides you with the necessary hooks to retrieve or manipulate data on your backend.
+- **For React-based storefronts:** you can use [Medusa React](../medusa-react/overview.mdx). It provides you with the necessary hooks to retrieve or manipulate data on your backend.
 - **For JavaScript frameworks:** you can use [Medusa’s JavaScript Client](../js-client/overview.md) in any JavaScript framework. This NPM package facilitates interacting with the backend’s REST APIs.
 - **For other frontend technologies:** you can interact directly with the Medusa backend by sending requests to its [Store REST APIs](/api/store).